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PREFACE 

This manual is for the person who has the responsibility to: 

1. Install the TOPS-20 software on a new DECSYSTEM-20. 

2. Update the TOPS-20 software system on an existing 
DECSYSTEM-20. 

To use this manual effectively, first read Getting Started With 
TOPS-20 . You should also become familiar with the information in the 
TOPS-20 User's Guide and the TOPS-20 Operator's Guide . 

You do not have to know assembly language programming or have previous 
experience installing a TOFS-20 software system, although both are 
helpful. 

Contents of This Manual 

Chapters 1 through 7 contain step-by-step instructions, with error 
recovery procedures, describing how to install a new Version 5 TOPS-20 
software system. 

Appendix A contains step-by-step instructions describing how to update 
a Version 4 TOPS-20 software system to Version 5. 

After you complete either the set of steps in Chapters 1 through 7 or 
the steps in Appendix A, your system is ready for timesharing. 

Appendix B is a pocket installation guide for the experienced 
installer. This appendix contains the text and output from a sample 
installation, but does not cover error recovery procedures. The steps 
in this appendix are keyed to the body of this manual so that you can 
easily refer to a complete description of any step. 

Appendix C describes the procedures for tailoring your system for the 
ARPA network. 

Appendix D contains the procedures for generating a tailored batch 
system. 

The commands you must type are printed in RED. If you type 
accurately, all you have to do is perform the indicated function and 
verify that your actual terminal output resembles the sample output. 
Remember that systems differ in memory size and peripherals, so steps 
that describe configuring memory, initializing line printers and disk 
packs, and assigning logical unit numbers to tape drives require you 
to type the values that are correct for your system and not the sample 
parameters. 

vii 



If your terminal output does not resemble the sample output, first 
read ALL the instructions after the word "Error", then choose the 
recovery procedure that corrects your problem. 

NOTE 

The version and edit numbers in this 
manual could differ from the numbers 
printed on your console terminal. The 
numbers printed on your console must be 
equal to or greater than the numbers in 
this manual. 

Time estimates are included so that you know about how long a step 
takes. Times are estimated to the nearest minute, so don't worry if a 
step takes somewhat longer or shorter than this. 

Checking off each step as you complete it is a good way to keep your 

place . 

Symbols Used in This Manual 

Ctrl/* ) Indicates where you type a control backslash. This is done 
by holding down the CTRL key while typing a backslash. The 
backslash key is located near the key labeled LINEFEED or 
LF. 

(Eg) Indicates where you press the key labeled ESC, ESCAPE, 
PREFIX, ALT, or ALTMODE. 

© Indicates where you press the RETURN key. 

Reference Documentation 

The following manuals are valuable as references for users of this 
manual. Their order numbers are also shown. These manuals are 
included in the TOPS-20 Software Notebook Set. 

Manual Title Order No. 

TOPS-20 Commands Reference Manual AA-5115B-TM 

TOPS-20 EDIT Reference Manual AA-5415A-TM 

TOPS-20 Monitor Calls Reference Manual AA-4166E-TM 

TOPS-20 Operator's Guide AA-417 6D-TM 

TOPS-20 O P R Command Language Reference Manual AA-H6 00A-TM 

TOPS-20 System Manager's Guide AA-4169F-TM 

TOPS-20 User Utilities Guide AA-D8 50A-TM 

TOPS-20 User's Guide AA-4179C-TM 
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CHAPTER 1 
INTRODUCTION 



Installing the TOPS-20 software on the DECSYSTEM-20 is not a hard task 
if you follow the procedures outlined in the following chapters. 



1.1 SUMMARY OF CONTENTS 

Chapter 1 explains some of the procedures to follow. It also 
describes the tools you need to install the software. 

Chapter 2 describes powering up the DECSYSTEM-20 and obtaining the 
DECSYSTEM-20 front-end monitor from floppy disk. This chapter also 
describes loading the TOPS-20 bundled software from magnetic tape. 

Chapter 3 describes how to select the proper monitor, declare the 
system name, and change the system defaults for terminals, system 
devices, accounting, performance improvements, scheduler controls, and 
file archiving and migration. 

Chapter 4 describes how to create the front-end file system for the 
DECSYSTEM-20 and copy files into it from the floppy disk. Upon your 
completion of this chapter, the installation is complete. 

Chapter 5 describes how to boot the system from disk. 

Chapter 6 describes how to install any additional software you have 
purchased. This software may be software for unbundled products or 
periodic updated software. 

Chapter 7 describes how to run the User Environment Test Package (UETP 
program) . This program performs a cursory check of the system. 

Appendix A contains step-by-step instructions and pointers to various 
chapters within the manual, describing how to update a Version 4 
TOPS-20 software system to a Version 5 TOPS-20 software system on the 
DECSYSTEM-20. 

Appendix B is a pocket installation guide for the experienced 
installer. It contains the text and output from a sample installation 
of the TOPS-20 software on a DECSYSTEM-20, Model 2060. This appendix 
does not have error recovery procedures. The steps are keyed to the 
steps within the body of this manual that describe how to install the 
TOPS-20 software on a DECSYSTEM-20. 

Appendix C contains the steps for tailoring your system for the ARPA 
network. 

Appendix D contains the steps for generating a batch and spooling 
(Galaxy) system tailored for your particular site. 
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INTRODUCTION 

The TOPS-20 System Manager's Guide contains helpful hints on how to 
manage* a TOPS-20 timesharing system. A system manager should read 
this manual before making timesharing generally available to users. 

NOTE 

Before starting the installation, read 
the listing labeled TOPS20.BWR, which 
accompanies your software. The 
TOPS20.BWR file describes changes in the 
software made too late for inclusion in 
this manual. 



1.2 PREPARING FOR INSTALLATION 

A DIGITAL Field Service Representative will install your DECSYSTEM-20 
hardware and inform you when the system runs diagnostics correctly. 
Before he leaves, obtain the following information: 

1. The channel, unit, and controller number of each disk drive, 
and whether it is dual-ported. The controller number for 
RP04, RP06, and RP07 is -1. RP20 disk drives have a 
different controller number. The unit number is located on 
the display panel on the drive. The DECSYSTEM-20 dual-ported 
disk drives are connected to both the CPU and the front-end 
processor. It is an error if two dual-ported drives with the 
same unit number are connected to the front-end processor. 
The procedures in this manual assume that the unit on which 
you are installing the front-end software is Unit 0. 

Disk Drives 

Type Channel # Unit # Controller # Dual-Ported ? 
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A list of line numbers and line speeds. Use these numbers in 
Section 3.3.1 when you set the default terminal speeds. 
Also, find out which lines are remote so that you can define 
the remote lines as described in Section 3.3.2. 



Lines 

Auto Auto 

Line # Speed Remote? Line # Speed Remote? 



NOTE 

The word Auto over the word Speed declares that the 
line is specified as an autobaud line in Section 
3.3.^!. 
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INTRODUCTION 

The serial number of each magnetic tape drive. Use these 
numbers in Section 3.3.4 to define magnetic tape logical unit 
numbers. The number appearing on the thumbwheel does not 
necessarily correspond to the logical unit number of the 
dr ive . 

Magnetic Tapes 

Serial # Type Serial # Type Serial # Type 



NOTE 

The serial numbers on TU70 and/or TU71 tape drives 
are made up of three factors. These factors consist 
of the RH20 channel number, the DX20 number, and a 
two-digit tape unit number. Assuming that the RH20 
channel number is 2, the serial number for tape unit 
3 would be as follows: 

2003 

In the above example, the RH20 channel is the first 
digit (2) , the DX20 number is the second digit (0) , 
and the last two digits are the tape unit number 
(03) . The serial number for a TU72 tape drive can be 
found on the back of the tape drive. 



4. The unit number and type of each line printer. Use this 
information in Section 3.3.5 to initialize the line printers. 

Line Printers 

Programmable 
Unit # Model # Lowercase ? VFU ? 
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INTRODUCTION 

1.3 INSTALLATION TOOLS 

You need the following tools to install the TOPS-20 software on a 
DECSYSTEM-20: 

1. The RSX-20F System Floppy A. The files on this floppy are 
used to boot the central processor from an RP04 or RP06 disk 
pack. 

2. The RSX-20F System Floppy B. The files on this floppy are 
used for various functions in installing and maintaining the 
software on a DECSYSTEM-20. 

3. The RSX-20F System Floppy C. This floppy contains the 
RSX-20F map file. 

4. The TOPS-20 V5 Installation Tape and the TOPS-20 Distribution 
tape. When installing the TOPS-20 software on a DECSYSTEM-20 
model number 2060 or on a DECSYSTEM-20 model number 2040S, 
you should be using software package QT023, which contains 
the Installation Tape labeled TOPS-20 2060 INSTL.MT V5 and 
the Distribution Tape labeled TOPS-20 2060 DIST.MT V5 . 

The TOPS-20 V5 Installation Tape for 2040S, 2060, and ARPANET 
systems contains the TOPS-20 monitor and related programs. 
The files on this tape are: 

The TOPS-20 monitor (SAVE format) 

The TOPS-20 command processor (SAVE format) 

The DLUSER program (SAVE format) 

DLUSER data (ASCII file) 

The DUMPER program (SAVE format) 

Four DUMPER savesets recorded at 1600 bpi in DUMPER 
format for the following directories: 

PS:<SYSTEM> 

PS:<SUBSYS> 

PS:<UETP.LIB> 

PS : <GALAXY-SUBSYS> 

The TOPS-20 Distribution Tape for all DECSYSTEM-20s contains 
the TOPS-20 bundled software. There are four DUMPER save 
sets recorded at 1600 bpi in DUMPER format. The contents of 
the savesets are: 

Saveset 1 contains documents about the software. 

Savesets 2 through 4 contain source files needed to 
build the software in the directories <SYSTEM> and 
<SUBSYS>, except for the monitor and the TOPS-20 command 
processor . 

5. If you are installing the TOPS-20 software on a 
DECSYSTEM-2040S or DECSYSTEM-2060 that contains an RP20 Disk 
Subsystem, you should receive a DX20 microcode tape 
containing the microcode necessary to boot the DX20. 



1-5 



INTRODUCTION 

A separate tape for each optional software product you have 
purchased. Chapter 6 describes the format of these tapes. 



NOTE 

The term "bundled software" refers to the contents 
of the Installation and Distribution tapes 
considered together, or to the contents of the 
Distribution tape alone. The term "unbundled 
software" refers to the contents of the various 
tapes described in Chapter 6. 

Formatted disk packs. If your disk packs are not formatted, 
ask your DIGITAL Field Service Representative to format them 
for you. 



1.4 THE TOPS-20 MONITORS 

Six monitors are distributed with the TOPS-20 V5 software for the 
DECSYSTEM-20 Models 2040S, 2060, and ARPANET systems. They are: 

2060-MONBIG.EXE 

2060-MONMAX.EXE 

AN-MONSML.EXE 

AN-MONMED.EXE 

AN-MONBIG.EXE 

AN-MONLGE.EXE 

All the monitors mentioned above are described in Chapter 3. The 
installation will proceed more smoothly if you take time now to decide 
the monitor you want to use. 



1.5 THE BATCH AND SPOOLING SYSTEM 

Your TOPS-20 software system initialization includes a standard Galaxy 
batch and spooling system. If you need a special batch and spooling 
system, first install the standard system; then refer to Appendix D 
of this manual for instructions on how to build your own specialized 
batch and spooling system. 
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CHAPTER 2 
CREATING THE TOPS-20 FILE SYSTEM 



This chapter describes how to create a new TOPS-20 file system on the 
DECSYSTEM-20. 

STOP : These Procedures Install a New System 

Follow the procedures in this chapter if 
you are installing TOPS-20 Version 5 
software on a new system, or if you are 
creating a new file system on a set of 
disk packs. Use Appendix A to update 
from TOPS-20 Version 4 to Version 5 
software on an existing system. 



2.1 CHECKING THE TOPS-20 SOFTWARE PACKAGE 

The TOPS-20 software package contains the following items. Check to 
be sure that you have all of them. 

1. RSX20F System Floppy A 

2. RSX20F System Floppy B 

3. RSX20F System Floppy C 

4. TOPS-20 Installation Tape V5 

Throughout the rest of this text, this tape is referred to as 
the Installation tape. 

5. TOPS-20 Distribution Tape V5 

6. The DX20 Microcode Tape (RP20 Customer only) 

7. A separate tape for each optional software product purchased. 
Chapter 6 lists the optional software products, describes the 
format of the tapes, and tells how to install them. 

Refer to Chapter 1, Section 1.3 for the contents of the floppy disks 
and magnetic tapes. 
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CREATING THE TOPS-20 FILE SYSTEM 

2.1.1 Preparing the DECSYSTEM-20 for Installation 

Prepare the system for installation by powering it up and mounting the 
disk packs. 

t^ Step 1: Read the Listing Labeled TOPS20.BWR. 

Read the listing labeled TOPS20.BWR to learn about any last-minute 
changes made to the installation procedure or to the TOPS-20 software. 

t^ Step 2: Ask Your DIGITAL Field Service Representative if the Disk 
Packs Are Formatted. 

Ask your DIGITAL Field Service Representative if the disk packs are 
formatted for use with the DECSYSTEM-20. If they are not, ask him to 
format them. You cannot use the RP20 for the system structure. The 
packs must be formatted before you proceed further. 

t^ Step 3: Power Up the System. 

Turn on the power by pressing the POWER switch if the light under the 
word POWER on the operator's panel is off. (Do not touch the 
emergency power switch unless you see smoke or sparks coming from the 
system.) The system is ready after a few seconds, and the power light 
comes on. 

Be sure that the system is completely powered on: 

1. Check the disk drives. 

2. Check the magnetic tape drives. If power is off, press the 
rocker switch, i.e., the white switch containing the ON/OFF 
light, on the front panel. If you have trouble with the disk 
drives or magnetic tape drives, call your DIGITAL Field 
Service Representative for assistance. 

3. Check the line printers. If power is off for an LP20A or 
LP20B printer (which has four buttons on the right of the top 
panel), reset the knee-level breaker on the lower panel. The 
TAPE light may be on; disregard it. If you have an LP20F or 
LP20H printer (which has four rocker switches on the left of 
the top panel) , lift the cover just above the lights and 
reset the breaker. Be sure that the printer has paper. 

4. Turn on the console terminal. Be sure that it is on line and 
has paper. 

t^ Step 4: Label the Disk Packs. 

This manual contains the procedures for creating the system structure 
for your system. The system structure name can be up to six 
characters and contains the files needed to run the system. The 
system structure cannot include RP20 disk drives. If the system 
structure is on an RP07 disk drive, the front-end file system must 
reside on a RP04 or RP06 dual-ported disk drive. Decide how many 
packs you will have, and assign them consecutive "logical unit 
numbers," starting with 0. These are the logical pack numbers 
referred to in Step 25. 
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CREATING THE TOPS-20 FILE SYSTEM 

Identify each pack by writing these numbers with a felt-tip pen on the 
pack cover with a gummed label. A sample of the format of the label 
is : 

TOPS-20 Disk Pack 

Structure ID:: structure name 

Logical Unit: n 

CAUTION 

Do not use a gummed label on the surface 
of" the pack itself , because it can spin 
off and cause severe damage to the 
drive. 

W^ Step 5: Mounting an RP04 or RP06 Disk Pack. 

Mount the disk packs on the proper drives. RP04 and RP06 disk packs 
are similar in appearance but can be distinguished by the name RP04 or 
RP06 written on the upper surface of the pack. Make sure you place 
one pack on the drive that is unit 0, dual ported, and connected to 
the front-end. The installation procedure stores the files used by 
the front-end on this pack. After the installation is complete, you 
may dismount the disk packs so that the drives can be cleaned and 
maintained. However, during system operation, the pack that contains 
the front-end files must be on dual-ported drive as it was during 
installation. 

Be careful when mounting a disk pack because the drive shaft can be 
damaged if the pack is jammed off center into the drive. Follow these 
instructions when mounting a pack: 

NOTE 

RP07 and RP20 disk packs are 
non-removable . 



1. If another RP04 or RP06 disk is already mounted on the drive 
and spinning, press the START/STOP button and wait until the 
drive stops. 

2. Push the door back; slide the pack cover down over the pack. 

3. Turn the cover handle counterclockwise a few turns until it 
turns freely. Gently lift the pack vertically. If there is 
any resistance, turn the handle a few more turns 
counterclockwise and lift again. 

4. Lift the pack out of the drive and place it on the protective 
bottom cover. Be sure that the cover clicks closed. 

5. Pick up the pack to be mounted and remove the protective 
bottom cover by squeezing the handle of the bottom cover. 

CAUTION 

If you insert a pack without removing the bottom 
cover, you will be unable to use or remove the pack. 
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Gently lower the pack vertically into the drive, being 
careful not to hit the sides of the drive. Keep the pack 
centered in the drive while lowering it. 

6. Turn the handle clockwise about two full turns. You will 
feel a resistance roughly equal to the power steering on a 
car. When the resistance increases noticeably, stop turnin g 
or damage will result. 

7. Lift off the cover vertically. 

8. Close the door to the drive. 

9. Start the drive by pressing the START/STOP button. The disk 
is ready to be used when the READY light comes on. (On an 
RP06 the DOOR LOCKED light ensures that the disk is mounted 
properly. ) 

10. Be sure that the drive is not write protected. The switch 
labeled WRITE PROTECT must be off. 



CAUTION 

Do not leave a disk pack or magnetic 
tape on top of a disk drive. The 
vibration from the drive can cause these 
items to fall to the floor, causing 
expensive and irreparable damage. 

^Step 6: Check the CONTROLLER SELECT Switches. 

Be sure that the CONTROLLER SELECT switch on dual-ported drive is 
set to A/B and that every other drive has the CONTROLLER SELECT switch 
set to A. To change the CONTROLLER SELECT switch, set the switch to 
the desired position and press the STOP button to cycle the drive 
down. When the drive has stopped spinning, press the START button and 
wait for the READY light to come on. 

^Step 7: Mount System Floppy A in Drive 0. 

CAUTION 

Make sure that the paper directory that 
is sometimes included with the floppy 
disk is not sticking to the back of the 
floppy disk. Failure to do so will 
damage the floppy disk and the floppy 
drive. 

Place the floppy disk labeled: 

System Floppy A 

in the left floppy drive (drive 0). To mount a floppy disk, hold the 
floppy disk with your thumb on the label. Then with your thumb and 
the label facing upward, slide the floppy disk into the floppy drive 
until it contacts the back of the drive and stops. Press down the bar 
until it clicks. 
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W^ Step 8: Mount System Floppy B in Drive 1. 

In the right floppy drive (drive 1), place the floppy disk labeled: 
System Floppy B 

HINT 

Be sure that you have mounted the floppy 
disks in the correct drives, or problems 
will develop in Step 12. 

^ Step 9: Mount the Installation Tape on MTAO:. 

Remove the write ring (if present) from the magnetic tape labeled: 

TOPS-20 Installation Tape 

and mount the tape on drive 0. Drive is the lowest unit on the 
lowest channel on the lowest TM03, TM02 controller or DX20 controller. 
Your DIGITAL Field Service Representative gives you this information. 
If you cannot determine which drive is drive 0, make sure that all 
drives are off line except the one you want to use. 

NOTE 

Be sure to mount the correct version of 
the Installation tape. Refer to Chapter 
1, Section 1.3 for the correct 
Installation tape for your system. 



CAUTION 

The logical unit number for a magnetic 
tape drive is not determined by the 
numbered thumbwheel on the left side of 
TU45 drives. The numbered thumbwheel is 
the slave number of the drive. Never 
change the setting of this thumbwheel. 

To mount a reel of tape on a TU45 tape drive: 

1. Place the reel on the top hub with the labeled side of the 
tape facing you. 

2. Lock the reel on the hub by pressing the rocker in the center 
of the hub. 

3. Thread the tape through the slot in front of the tape heads 
by following the arrows. Move the head shields back for 
easier access to the tape slot. 

4. Wind the tape one turn clockwise onto the take-up reel. 
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5. Press the LOAD button. The tape slowly advances onto the 
take-up reel and moves to the logical beginning of the tape. 
If the drive overshoots the beginning of the tape, it 
repositions itself. 

6. Make sure the ON LINE button is lit; if it is not, press the 
ON LINE button. 

To mount a reel of tape on a TU77 or TU78 tape drive: 

1. Place the reel of tape on the top hub with the labeled side 
of the tape facing you. 

2. Lock the reel on the hub by pressing the rocker in the center 
of the hub. 

3. Press, in order, the RESET and LOAD buttons. The tape is 
wound counterclockwise a few turns. Then the tape leader is 
threaded automatically through the slot near the upper 
right-hand corner of the drive, and the tape is positioned at 
the logical beginning of tape. 

4. Press the ON LINE button. 

On completion, the LOAD, ON LINE, and FILE PROTECT (FPT) lights should 
be on, indicating that the tape is positioned at the beginning. When 
the FILE PROTECT light is on, the system cannot write on the tape. If 
the FILE PROTECT light is not on, remove the write ring from the back 
of the tape. 

To mount a reel of tape on a TU72 tape drive: 

1. Place the reel of tape on the rightmost hub with the labeled 
side of the tape facing you. 

2. Thread the tape leader down the slot until it is 
approximately three inches in front of the read/write head. 

3. Press, in order, the RESET, LOAD, and START buttons. The 
tape leader is threaded automatically on the take-up reel and 
the tape is positioned at the logical beginning of tape. 



2.1.2 Loading and Starting the TOPS-20 Monitor 

To create the TOPS-20 file system, you need to load the TOPS-20 
monitor into the system and start the file system initialization 
routine. Perform steps 10 through 19 to load and start the TOPS-20 
monitor . 

1. Load the front-end monitor from the floppy disks. Use the 
front end to initialize the central processor and memory. 

2. Use the front-end monitor to load the TOPS-20 Magnetic Tape 
Bootstrap (MTBOOT) program from System Floppy A into the 
central processor. 

3. Use MTBOOT to load the TOPS-20 monitor from magnetic tape 
into memory. 

4. Use MTBOOT to start the TOPS-20 monitor at the file system 
initialization routine. 
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W^ Step 10: Place the Front-End HALT Switch in the ENABLE Position. 

Open the second door from the left side of the DECSYSTEM-20 , directly 
under the DECSYSTEM-20 control panel, to access the front-end 
switches . 

Be sure that the front-end HALT switch is in the ENABLE position 
(Figure 2-1) . If the switch is in the HALT position, move it up to 
the ENABLE position. When the HALT switch is in the HALT position, 
the front end will not operate. 

W^ Step 11: Set the Switch Register to 000007 (octal). 

The front-end control panel has 16 switch register switches (Figure 
2-1). Set them to 000007 (octal) by setting switches 2, 1, and up, 
and leaving the rest down. (Refer to Part 4, Chapter 1 of the TOPS-20 
Operator's Guide for a detailed description of all switches.) 

Booting the front end from a floppy disk with the switch register set 
to 000007 causes the front-end monitor to run the central processor 
initialization dialog. This loads the central processor microcode and 
configures central processor memory. 

^Step 12: Hold ENABLE and Press the SWITCH REGISTER Button. 

Hold ENABLE and press the SWITCH REGISTER button on the control panel 
(Figure 2-1) ; this loads the front-end monitor and starts the 
initialization dialog. The system prints: 

RSX-20F YB14-44 6:11 5-MAR-82 

[SY0: REDIRECTED TO DX0 : ] 

[DX0: MOUNTED] 

[DXl: MOUNTED] 

KLI — VERSION VB12-27 RUNNING 

KLI — ENTER DIALOG [NO , YES , EXIT , BOOT] ? 

KLI> 

Item Identifies 

RSX-20F The name of the front-end monitor. 

YB14-44 The version of the front-end monitor. 

6:11 5-MAR-82 The time and date that the front-end monitor 

was built . 

SY0 : The area from which the front end obtains its 

files. If SY0 : is redirected to DX0 : , the 
front end obtains the files from floppy drive 
0. If SY0 : is redirected to DBO : , the front 
end obtains the files from disk drive 0. 

KLI The name and version of the central processor 

initialization dialog. 

KLI> The prompt for the central processor 

initialization dialog. 

Error: If the system does not print the above heading, be sure that 
the floppy disks are mounted in the proper drives and the 
HALT switch is in the ENABLE position. Then retry Step 12. 
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NOTE 



The version and edit numbers in this manual could 
differ from the numbers printed on your console. 
The numbers printed on your console must be equal to 
or greater than the numbers in this manual. 



■LOAD SWITCHES - 



DISK 



ENABLE 



SW REG 



POWER POWER 
LIGHT SWITCH 



EMERGENCY 
POWER OFF 




SWITCH REGISTER 



ENABLE/HALT 
SWITCH 
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^ Step 13: Type YES and Press the RETURN Key. 

To enter the central processor initialization dialog, type YES and 
press the RETURN key. Following this, if you answer either NO or YES 
to this question, you will see a description of your system's 
hardware. First comes the serial number (S/N) of the CPU, followed by 
its type and power line frequency (either 50 or 60 Hertz) . Then comes 
a list of hardware options present on your system. If an item is not 
present, it will not be listed. The example below shows all available 
options. Following this, the system prints KLI — RELOAD MICROCODE 
[YES, VERIFY, FIX, NO] ?: 

KLI — ENTER DIALOG [NO , YES , EXIT , BOOT] ? 

KLI>YES®) 

KLI — KL10 S/N: 2102., MODEL B, 60 HERTZ 

KLI — KL10 HARDWARE ENVIRONMENT: 

MOS MASTER OSCILLATOR 

EXTENDED ADDRESSING 

INTERNAL CHANNELS 

CACHE 

KLI — RELOAD MICROCODE [ YES , VERIFY , FIX , NO] ? 
KLI> 

Error: If the system does not print the above heading, be sure that 
the floppy disks are mounted in the proper drives, then 
return to Step 12. 

DELETE KEY 

If you make a typing error, press the DELETE key to 
erase a single character at a time. Type CTRL/U to 
delete the entire line. 

^ Step 14: Type YES and Press the RETURN Key. 

To load the central processor microcode, type YES and press the RETURN 
key. After 30 seconds, during which the floppy drives click, the 
microcode is loaded and the system prints KLI — MICROCODE VERSION 273 
LOADED followed by KLI — RECONFIGURE CACHE [ FILE ,ALL , YES ,NO] ? 

KLI — RELOAD MICROCODE [ YES , VERIFY , FIX , NO] ? 

KLI>YES© 

KLI — MICROCODE VERSION 273 LOADED 

^ Step 15: STOP. 

Go to Step 16 if the system prints: 

KLI — RECONFIGURE CACHE [ FILE ,ALL , YES ,NO] ? 

Go to Step 17 if the system prints: 

KLI — CONFIGURE KL MEMORY [ FILE , ALL , REVERSE , FORCE , YES , NO] ? 
KLI> 



2-9 



CREATING THE TOPS-20 FILE SYSTEM 



Step 16: Type ALL and Press the RETURN Key. 

To reconfigure the central processor cache, type ALL and press the 
RETURN key. Upon receiving this reply, the system configures all 
available cache. After the configuration is complete, the system 
prints : 



KLI>ALL(H) 

KLI — ALL CACHES ENABLED 

KLI — CONFIGURE KL MEMORY 

KLI> 



; FILE, ALL, REVERSE, FORCE, YES, NO] ? 



Error: If the system does not print one of the headings above, be 
sure that the floppy disks are mounted in the proper drives, 
then return to Step 12. 

^Step 17: Type ALL and Press the RETURN Key. 

To configure the central processor memory, type ALL and press the 
RETURN key. This answer configures all available memory in the most 
useful manner and then prints a message indicating the results. These 
results will be different, depending on the type of hardware you have. 
See below, for the sample output that pertains to your system. (Refer 
to the TOPS-20 Operator's Guide for details on memory configuration.) 
After the configuration is complete, the system prints KLI — LOAD KL 
BOOTSTRAP [ YES, NO, FILENAME] ?: 

KLI -- CONFIGURE KL MEMORY [ FILE , ALL , REVERSE , FORCE , YES , NO] ? 
KLI>ALLdl) 

Depending on the size of your system, your output will resemble one of 
the following: 

LOGICAL MEMORY CONFIGURATION 

ADDRESS SIZE INT TYPE CONTROLLER 

00000000 768K 4 MF20 11 

or 



LOGICAL MEMORY CONFIGURATION 

ADDRESS SIZE INT TYPE CONTROLLER 

00000000 128K 4 MB20 % 1 

00400000 512K 4 MF20 10 

02400000 256K 4 MF20 14 



03400000 



3200K 



NON-EXISTENT 



NOTE 

The MOS memory configurator is capable 
of configuring 4096K of memory. The 
message concerning the NON-EXISTENT 
memory may be ignored. This message is 
specifying the difference between the 
actual physical memory and 4096K. 



Error: If the system does not print a heading similar to one of 
those above, be sure that the correct floppy disks are 
mounted in the proper drives, then return to Step 12. 
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W^ Step 18: Type MTBOOT and Press the RETURN Key. 

After the prompt KLI>, type MTBOOT and press the RETURN key: 

KLI — LOAD KL BOOTSTRAP [ YES , NO , FILENAME] ? 

KLI>MTBOOT@) 

KLI — WRITE CONFIGURATION FILE [YES, NO]? 

KLI> 

The system asks whether it should write the front-end file KL.CFG, 
which describes your current configuration and the method you used to 
bring up the system (disk, floppy disks, or magnetic tape). If this 
file is written, the front end will attempt to use the same method and 
the same configuration when you next install or reload the system. 
The default answer to the question, WRITE CONFIGURATION FILE 
[YES,NO]?, is YES. Therefore, it is recommended that you answer NO to 
this question for the present. Later, when you have a front-end 
configuration that should be recorded (Step 136, in Chapter 5), the 
configuration file will be written for you. 

W^ Step 19: Type NO and Press the RETURN Key. 

After the prompt KLI>, type NO and press the RETURN key. 

KLI — WRITE CONFIGURATION FILE [YES, NO]? 

KLI>NO(© 

KLI — BOOTSTRAP LOADED AND STARTED 

BOOT V10.0 (151) 

MTBOOT> 

The front end loads the central processor memory with the bootstrap 
program from the floppy mounted on drive 0, and then starts the 
bootstrap program. When at bootstrap command level (about 45 
seconds), the system prints MTBOOT> . 

Error: If the system prints: 

KLI> — ?BOOTSTRAP LOAD FAILED 

or any other error message, you may have the wrong floppy 
disk mounted in drive or you may not have stopped the 
central processor. Type CTRL/\. (The backslash key (\) is 
near the LINEFEED key.) After 10 seconds, the system prints 
PAR> . Type the command ABORT and press the RETURN key. The 
system prints PAR% , which means the central processor has 
stopped. Go back to Step 12. 

If the system prints the following message exactly: 

KLI — ?BOOT FILE NOT FOUND 

KLI — ?BOOTSTRAP LOAD FAILED 

KLI — ENTER DIALOG [ NO , YES , EXIT , BOOT] ? 

KLI> 

You either have the wrong floppies mounted or you mistyped 
the name of the bootstrap. Go back to Step 13. If the 
error recurs, make sure that you have mounted the proper 
floppy disks. If the error continues, contact Digital 
Software Support. 
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^Step 20: Type /L and Press the RETURN Key. 



To load the TOPS-20 monitor from magnetic tape into memory, type /L 
and press the RETURN key. The system rewinds the tape on drive 0, 
loads the resident monitor, skips a line, and prints the MTBOOT> 
prompt : 

MTBOOT>/L@ 

[BOOT: STARTING CHN:1 DX20X:0 MICROCODE V7(0)] [OK] 

[BOOT: LOADING RESIDENT MONITOR] [OK] 



MTBOOT> 



NOTE 

The message concerning the DX20 
microcode is printed only if you are 
installing the TOPS-20 software on a 
DECSYSTEM-20 with a DX20 tape or disk 
controller . 



Error: If you have made a typing error and pressed the RETURN key, 
the system prints the MTBOOT> prompt again. Reissue the 
correct command. 



If you did not put the magnetic tape 
prints: 



on 



line, the system 



?NO RDY DRIVE 
MTBOOT> 

Place the tape on line and give the /L command again. 

If the system prints the message: 

?BAD FIL FMT, or 
?BAD EXE DIR 

Make sure that you have mounted the correct TOPS-20 
Installation tape on drive and that all other tape drives 
are off line. Then rewind the tape and try giving the /L 
command again. If the error recurs, call DIGITAL Software 
Support . 

Error: If the system does not print the MTBOOT> prompt, you 
probably mistyped the name MTBOOT. The system prints the 
message: 



KLI -- 
KLI -- 
KLI -- 
KLI> 



?BOOT FILE NOT FOUND 

?BOOT LOAD FAILED 

ENTER DIALOG [ NO , YES , EXIT , BOOT] ? 



If the floppy disks are mounted properly and you typed 
MTBOOT properly, go back to Step 12. If the error recurs, 
contact DIGITAL Software Support. 
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The system will use the magnetic tape that is on line. 

Check to see if you have more than one tape drive on line. 

If so, press the ON LINE button to take each unwanted drive 
off line. Try typing /L again. 

NOTE 

The following procedure is intended for use during 
installation only. If you are trying to bring up a 
monitor that has already been installed on a set of 
TOPS-20 disk packs, refer to Step 136 in Chapter 4 
of this manual or to the TOPS-20 Operator's Guide 
for the correct procedure. 

^Step 21: Type /G143 and Press the RETURN Key. 

To start the TOPS-20 file-system initialization routine, type /G143 
and press the RETURN key. The system starts the TOPS-20 monitor at 
the file-system initialization routine: 

MTBOOT>/G143® 

[FOR ADDITIONAL INFORMATION TYPE "?" TO ANY OF THE FOLLOWING 
QUESTIONS. ] 

DO YOU WANT TO REPLACE THE FILE SYSTEM ON THE SYSTEM STRUCTURE? 

Error: If you make an error and the system reprints the MTBOOT> 
prompt, reissue the correct command. 

If the system does not print the MTBOOT> prompt, check your 
typescript. Go back to Step 12. 

If the system prints: 

?BAD EXE DIR 

you probably typed the wrong command. Try giving the /G143 
command again. If you still get an error, go back to 
Step 12. 



2.2 INITIALIZING THE TOPS-20 FILE SYSTEM 

To initialize the TOPS-20 file system, you must define the name of the 
system structure and the number and location of each disk pack that is 
part of the systeir structure. 

The steps in this section initialize the TOPS-20 file system by 
creating : 

1. New home blocks (which contain pointers to the beginning of 
the file system) . 

2. The directory <ROOT-DIRECTORY> (which contains pointers to 
all the directories in the system) . 

3. The directories <SYSTEM> , <SUBSYS>, <NEW-SYSTEM> , 
<NEW-SUBSYS>, <UETP>, <UETP.LIB>, <UETP.RUN>, <ACCOUNTS> , 
<SYSTEM-ERROR> , <OPERATOR> , and <SPOOL> . 
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4. Space for the front-end file system. 

5. The system swapping space (the area allocated for the 
movement, by the monitor, of pages between memory and disk). 



NOTE 

Refer to the TOPS-20 System Manager's 
Guide for a detailed explanation of all 
the above. 

t^ Step 22: Type YES and Press the RETURN Key. 

To create the system structure, type YES and press the RETURN key. 
[FOR ADDITIONAL INFORMATION TYPE "?" TO ANY OF THE FOLLOWING QUESTIONS, 
DO YOU WANT TO REPLACE THE FILE SYSTEM ON THE SYSTEM STRUCTURE? YES (SB) 
DO YOU WANT TO DEFINE THE SYSTEM STRUCTURE? 

^ Step 23: Type YES and Press the RETURN Key. 

To write the home blocks for each unit in the system structure, type 
YES and press the RETURN key. 

DO YOU WANT TO DEFINE THE SYSTEM STRUCTURE? YES© 

HOW MANY PACKS ARE IN THIS STRUCTURE: 

^ Step 24: Type the Number of Packs and Press the RETURN Key. 

Count the number of disk packs you plan to have in your system 
structure. Type the answer and press the RETURN key. The following 
example uses 1: 

HOW MANY PACKS ARE IN THIS STRUCTURE: 1® 

ON WHICH "CHANNEL, CONTROLLER, UNIT" IS LOGICAL PACK # MOUNTED: 

Error: If you type the wrong number of disk packs, type CTRL/\. 
After the system prints PAR> (10 seconds), type ABORT and 
press the RETURN key. The system prints PAR% (indicating 
that the central processor has stopped) . Go back to 
Step 12 and start again. 
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W^ Step 25: Type ? (Do Not Press the RETURN Key). 

You must inform the system of the location of each disk pack that is 
to be in the public file system. If you are not sure of the channel, 
controller, and unit numbers of each disk pack, type ?. This causes 
the system to print the channel and unit number of each disk drive: 

ON WHICH "CHANNEL, CONTROLLER, UNIT" IS LOGICAL PACK # MOUNTED: ? 

[ENTER A TRIPLE OF NUMBERS SEPARATED BY A COMMA THAT SPECIFY THE 
CHANNEL, CONTROLLER, AND UNIT UPON WHICH THE APPROPRIATE PACK IS 
MOUNTED. THE FOLLOWING IS A LIST OF VALID CHANNEL, CONTROLLER, 
UNIT NUMBERS: 

1,-1,0 ;TYPE=RP06,DUAL PORT 

1,-1,1 ;TYPE=RP06, OFFLINE, DUAL PORT 

1,-1,2 ;TYPE=RP04, OFFLINE, DUAL PORT 

1,-1,3 ;TYPE=RP07, OFFLINE 

] 

ON WHICH "CHANNEL, CONTROLLER, UNIT" IS LOGICAL PACK # MOUNTED: 

NOTE 

The controller number is always -1 for 
all system structures. 



Error: If you followed the procedure in Step 6 exactly, drive 
will be listed as dual-ported. Of the remaining drives, 
those that contain the packs that are to be your system 
structure will be listed as on line. All other drives will 
be listed as off line. 

If a drive that you want to use is not listed, the drive's 
controller select switch is probably set to B. Follow the 
procedure in Step 6 for changing it to A. Then type CTRL/\. 
After 10 seconds, the system prints PAR> . Type ABORT and 
press the RETURN key to halt the central processor. Return 
to Step 12 and start again. 

If a drive you want to use is listed as off line, turn it on 
line and wait for the READY light to come on. Go back to 
Step 12. 

^ Step 26: Type the Channel No., Controller No., Unit No., and Press 
the RETURN Key. 

Type the channel number, the controller number, and the unit number of 
the dual-ported drive, and press the RETURN key. You must answer this 
question once for each disk pack. If there is any problem, ask your 
DIGITAL Field Service representative to give you the channel and unit 
number of each drive. The controller number of all drives except the 
RP20 is -1. Since the RP20 cannot be used in the system structure, 
the controller number should always be 1. 

ON WHICH "CHANNEL, CONTROLLER, UNIT" IS LOGICAL PACK # MOUNTED: 

1,-1,0(1!) 

DO YOU WANT THE DEFAULT SWAPPING SPACE? 
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Error: If your answer is invalid, the system prints one of several 
messages and repeats the question. You can simply repeat 
the current step. 

Error: If your answer is valid but is not the one you wanted, type 
CTRL/\. After 10 seconds, the system prints PAR> . Type 
ABORT and press the RETURN key to halt the central 
processor. Go back to Step 12 and start again. 

^Step 27: Type ? (Do Not Press the RETURN Key). 

To determine the default size of the swapping space for your system, 
type ?. The system prints the default swapping space which is 15010 
for a 2060 or 2040S. 

If you are planning on using a monitor other than MONBIG for the 2060 
or 2040S, refer to Chapter 3, Section 3.1 for the correct swapping 
space for the monitor you choose. 

DO YOU WANT THE DEFAULT SWAPPING SPACE? ? 
[THE DEFAULT IS 15010 PAGES] (for a 2060 or 2040S) 

DO YOU WANT THE DEFAULT SWAPPING SPACE? 

^ Step 28: Type YES or NO and Press the RETURN Key. 

If you want to accept the default swapping space size, type YES, press 
the RETURN key, and proceed to Step 30. 

DO YOU WANT THE DEFAULT SWAPPING SPACE? YES® 

DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? 

If you want to specify the size of the swapping space, type NO and 
press the RETURN key. The formula for determining the proper swapping 
space for your system is found in the TOPS-20 System Manager's Guide , 
Chapter 5. 

After you determine the size of the swapping space you need, proceed 
to Step 29. 

DO YOU WANT THE DEFAULT SWAPPING SPACE? NOCRB 

HOW MANY PAGES FOR SWAPPING? 

Error: If you type the wrong answer, type CTRL/\. After 10 
seconds, the system prints PAR> . Type ABORT and press the 
RETURN key to halt the central processor. Return to 
Step 12 and start again. 
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t^ Step 29: Type the Decimal Number of Pages and Press the RETURN Key. 

Type the decimal number of disk pages you want to assign for swapping 
and press the RETURN key. This option is provided so you can increase 
the amount of swapping space in the future. The default size is the 
maximum amount that your present monitor will use for swapping. If 
you decide to increase the amount used by the monitor in the future, 
you must already have assigned that much space on the disk during the 
installation procedure. Otherwise, you must repeat the installation 
procedure and specify the larger number. The system will round the 
number of pages specified up to an integral number of cylinders on the 
disk. 

HOW MANY PAGES FOR SWAPPING? n ED 

DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? 

Error: If you type an invalid number, the system prnts: 

? INVALID NUMBER OF SWAPPING PAGES FOR THIS TYPE OF DISK 

and returns to the question in Step 28. If you type an answer 
that is valid but is not the one you wanted, type CTRL/\. 
After 10 seconds, the system prints PAR> . Type ABORT and 
press the RETURN key to halt the central processor. Go back 
to Step 12 and start again. 

^ Step 30: Type ? (Do Not Press the RETURN Key). 

To determine the default size of the front-end file system, type ?. 
If you already know what the default is, you may omit this step. 

DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? ? 
[THE DEFAULT IS 950 PAGES] 

DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? 

NOTE 

If you are using an RP07 disk drive as 
the system structure, do not resesrve 
any pages for the front-end file system. 

^ Step 31: Type YES and Press the RETURN Key. 

Type YES, press the RETURN key, and proceed to Step 32. 

DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? YES ED 
DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA? 
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^ Step 32: Type ? (Do Not Press the RETURN Key). 

To find out how many pages are assigned as the default boot file 
space, type a question mark. The system responds with the number of 
pages allocated for the boot file space. 

DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA? ? 

[THE DEFAULT IS 64 PAGES] 

DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA? 

W^ Step 33: Type YES and Press the RETURN Key. 

It is recommended that you take the default bootstrap space. Type YES 
and press the RETURN key. 

DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA? YES (H) 

WHAT IS THE NAME OF THIS STRUCTURE? 

W^ Step 34: Type the Name of the Structure and Press the RETURN Key. 

TOPS-20 recognizes any six-character name as a valid structure name. 
Type the name of the structure and press the RETURN key. The 
following examples uses PS: as the structure name. 

WHAT IS THE NAME OF THIS STRUCTURE? PS:® 

[STRUCTURE "PS" SUCCESSFULLY DEFINED] 

W^ Step 35: STOP. 

The system now recognizes the structure you just defined and prints 

[STRUCTURE "PS" SUCCESSFULLY DEFINED] 

[PS MOUNTED] 

[BOOT: LOADING SWAPPABLE MONITOR, PASS 1] [OK] 

%%NO SETSPD 

If the system prints a message similar to: 

?PS UNIT HAS NO BAT BLOCKS 

DO YOU WANT TO WRITE A SET OF PROTOTYPE BAT BLOCKS? 

Type YES and press the RETURN key. Continue with the next step. 

%%NO SETSPD means that the system cannot run the SETSPD program. This 

is expected because you have not yet loaded the SETSPD program into 

the file system. This message may be printed at any time before the 
system requests the date and time. 
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Error: If certain error conditions occur while the monitor is 
mounting the structure (a drive is write protected, for 
example), the system prints an error message followed by: 

?HAVE THE PROBLEMS MENTIONED ABOVE BEEN CORRECTED YET: 

When the problem has been corrected, type Y and press the 
RETURN key. Go back to Step 12. 



2.3 STARTING THE MONITOR 

Now that the file system is initialized, you can start the system by 
performing the following steps. 

^ Step 36: Type the Date and Time, and Press the RETURN Key. 

The system prints 

System restarting, wait... 

ENTER CURRENT DATE AND TIME: 
Type the date and time in the following format: 

day-month-year hhmm 

Press the RETURN key. Type the time in AM/PM format or 24-hour 
format. For example, 4:30 PM on the second day of March may be 
entered as 2-MAR-81 4:30 PM: 

ENTER CURRENT DATE AND TIME: 5-MAR-82 1630© 

The system responds by retyping the date and time. 

YOU HAVE ENTERED SUNDAY, 5-MARCH-1982 4:30PM, 
IS THIS CORRECT (Y,N) 

^ Step 37: Type Y and Press the RETURN Key if the Date Is Correct. 

If the date and time are correct, type Y and press the RETURN key. If 
the date and time are incorrect, type N and press the RETURN key. The 
system again asks for the date and time: 

YOU HAVE ENTERED SUNDAY, 5-MARCH-1982 4:30PM, 

IS THIS CORRECT (Y,N) Y® 
WHY RELOAD? 

^ Step 38: Type NEW and Press the RETURN Key. 

Type NEW and press the RETURN key. Whatever text you type following 
this question is entered into the system error file, 
PS:<SYSTEM-ERROR>ERROR.SYS. The TOPS-20 monitor starts running, and 
the system prints <SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT 
VALIDATION IS DISABLED and RUNNING DDMP. 

WHY RELOAD? NEW (ED 

<SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED 

RUNNING DDMP 

NO SYSJOB 
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The system prints the message <SYSTEM>ACCOUNTS-TABLE . BIN NOT FOUND - 
ACCOUNT VALIDATION IS DISABLED because the ACTGEN program has not been 
run. (Refer to Chapter 6 of the TOPS-20 System Manager's Guide for 
more information.) The system prints NO SYSJOB because the SYSJOB 
program is not stored on disk. This program is not needed yet, so 
ignore this message. 

Error: If you type an incorrect string to the WHY RELOAD? 
question, the system prints the valid abbreviations and then 
prompts you again for the abbreviation. 

W^ Step 39: Type CTRL/C to Tell the System that You Want to Start a Job. 

<SYSTEM>ACCOUNTS. TABLE. BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED 
RUNNING DDMP 
NO SYSJOB 

i TRL;_C J 

NO EXEC 
MX> 

W^ Step 40: Type G, Then MTAO : and Press the RETURN Key. 

The system is now at the miniexec command level, and you can type any 
miniexec command. Use this command language to load the TOPS-20 
command processor from tape. Type CTRL/U if you want to erase a line 
while at miniexec command level. 

The system prints NO EXEC because the file PS: <SYSTEM>EXEC. EXE 
{containing the TOPS-20 command processor) does not exist. The 
command processor is not needed at this point, so ignore this message. 

To skip over the end of the monitor save file, type G. The system 
prints ET FILE. Type MTAO: and press the RETURN key. The system 
skips over the end of the monitor save file and prints the miniexec 
prompt MX> . 

NO EXEC 

MX>GET FILE MTAO : (rfQ 

MX> 



NOTE 

If you are using a tape drive other than 
tape drive 0, reply accordingly in the 
following steps and/or error recovery 
procedures, e.g., MTA1 : , MTA2 : . 



Error: If you get an error message in the form: 

INTERRUPT AT location 

where location is an octal number, you can ignore this 
message and continue with the next step. 
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^Step 41: Again Type G, Then MTAO:, and Press the RETURN Key. 

To load the TOPS-20 command processor from magnetic tape into memory, 
type G. The system prints ET FILE. Type MTAO: and press the RETURN 
key. The system reads the program from MTAO: into memory and prints 
the miniexec prompt when it is finished: 

MX>GET FILE MTAO:© 
MX> 

Error: If you get another error in the form INTERRUPT AT location, 
the tape could be bad or you may be specifying the wrong 
tape drive. Start at Step 10 once more. If the errors 
continue, call DIGITAL Software Support. 

If you make a typing mistake and press the RETURN key, the 
system prints the MX> prompt. Try again. 

^ Step 42: Type S and Press the RETURN Key. 

To start the TOPS-20 command processor that you just loaded into 
memory, type S. The system prints TART. Press the RETURN key. The 
system prints the name and version of the TOPS-20 command processor 
and the TOPS-20 prompt, @ : 

MX > START© 

TOPS-20 Command processor 5(514) 

@ 

Error: If the system prints INTERRUPT AT 1, you typed only one G 
command to the miniexec. Repeat the command in this step. 
If you still get the error, go back to Step 12. If the 
errors continue, contact DIGITAL Software Support. 

If you receive the error message INTERRUPT AT 601772, follow 
the error recovery procedures listed below. 

Rewind the tape manually and give the following commands: 

MX>GET FILE l-YTAG;® 

MX>RESET(® 

MX>GET FILE MTAO:© 

MX>START(H) 

Proceed to Step 43. 

If you make a typing error and press the RETURN key, the 
system prints the MX> prompt. Try again. 

Error: If many error messages are repeatedly printed, the tape 
could be bad. Press the front-end HALT switch and wait one 
minute. Go back to Step 12. If the errors persist, ask for 
another tape. 



2.4 CREATING SYSTEM DIRECTORIES 

With the system running, you must create directories to store system 
files and files for testing the system. You create these directories 
by running the DLUSER program from tape. 
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^ Step 43: Give the Comma: ENABLE (CAPABILITIES). 

To be able to load files into privileged areas and create user names 
and directories, give the ENABLE command to obtain the required 
capabilities. Type ENABLE and press the ESC key. The system prints 
(CAPABILITIES) . Press the RETURN key. The system prints a $ prompt 
instead of @: 

i;sc! 

T 

@ENABLE (CAPABILITIES)® 
$ 

t^ Step 44: Give the Command: RUN (PROGRAM) MTAO : . 

To run the DLUSER program from the magnetic tape, type RUN and press 

the ESC key. The system prints (PROGRAM). Type MTAO: and press the 

RETURN key. After you issue this command, the system prints the 
prompt DLUSER>: 

IESCI 

$RUN (PROGRAM) MTAO:© 
DLUSER> 

Error: If you receive an error message, rewind the tape, skip two 
files, and reissue this command. The following example 
shows how to do this for MTAO: 

T 

$REWIND (DEVICE) MTAO:® 
(ESC) 
1 
$SKIP (DEVICE) MTAO: 2 FILES® 

!ESC) 
1 

$RUN (PROGRAM) MTAO :(RfD 
DLUSER> 

W^ Step 45: Give the DLUSER Command: LOAD (FROM FILE) MTAO:. 

To load the directory structure from the tape into the file system, 
type LOAD and press the ESC key. The system prints (FROM FILE) . Type 
MTAO: and press the RETURN key. After a few seconds, the system 
prints DONE, and the DLUSER prompt: 

DLUSER>LOAD (FROM FILE) MTAO:© 

DONE. 
DLUSER> 

Error: If you mistype the command and have not pressed the RETURN 
key, delete the entire line by typing a CTRL/U, and reissue 
the command. 

If you mistyped the command and pressed the RETURN key, 
follow the error recovery procedure in Step 44. 
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If you get a group of JSYS error messages, you probably did 
not give the ENABLE command in Step 43. Type two CTRL/Cs, 
type ENABLE, give the commands in the following example, and 
reissue the command in this step: 

(ESC) 
i 
$REWIND (DEVICE) MTA0:(H) 
7DEVICE MTAO: OPEN ON JFN 3 
%CLOSE JFN? YES© 
3 MTAO: [OK] 

de) 
I 

$SKIP (DEVICE) MTAO: 4 FILES© 

(ESC) 

I 

$RUN (PROGRAM) MTAO:© 
DLUSER> 

^ Step 46 Type EXIT and Press the RETURN Key. 

Type EXIT and press the RETURN key to end the DLUSER program. The 
system prints $ : 

DLUSER>EXIT© 
$ 



2.5 RUNNING DUMPER FROM TAPE 

The DUMPER program places files from the magnetic tape into the 
TOPS-20 file system. The DUMPER program is the fifth file on the 
Installation Tape. 

^Step 47: Give the Command: RUN (PROGRAM) MTAO:. 

The DUMPER program is on the tape mounted on drive 0. Type RUN and 
press the ESC key. The system prints (PROGRAM) . Since the tape is 
already positioned at the DUMPER program, type MTAO: and press the 
RETURN key. After the DUMPER program starts, the system prints the 
DUMPER prompt: 

i 

$RUN (PROGRAM) MTAO:© 
DUMPER> 
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Error: If you get errors, the magnetic tape was either not recorded 
properly or not positioned properly. Rewind the tape, skip 
five files, and try again. The following lines show how to 
do this for MTAO : . If the errors persist, contact DIGITAL 
Software Support. 

Use) 

"i 
+ 

$REWIND (DEVICE) MTAO:® 

(ESC) 

i 

$SKIP (DEVICE) MTAO: 5 FILES® 
|SC] 
i 
$RUN (PROGRAM) MTAO: (RET) 

DUMPER> 

^Step 48: Give the DUMPER Command: TAPE (DEVICE) MTAO:. 

Tell DUMPER which tape drive to use by giving the DUMPER command TAPE. 
Type TAPE and press the ESC key. The system prints (DEVICE) . Type 
MTAO: and press the RETURN key. The system prints the DUMPER prompt: 



DUMPER>TAPE (DEVICE) MTAO:® 
DUMPER> 



Error ; 



If you make a typing error, reissue the command. 



2.6 RESTORING TOPS-20 BUNDLED SOFTWARE FROM TAPE 



Restore the files for the directories 
PS:<UETP.LIB> from the tape. 



PS:<SYSTEM>, PS:<SUBSYS>, and 



Give the DUMPER command FILES j ust before the RESTORE command if you 
want the system to print the file specification of each file it 
restores. The installation takes longer if you print this 
information. To stop printing each file specification, give the NO 
FILES command after the current RESTORE command finishes. 

(Refer to Chapter 7 of the TOPS-20 User Utilities Guide for an 
explanation of any messages that DUMPER may print on your terminal.) 
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NOTE 

The following steps assume you are 

restoring the files on the Installation 

tape to a structure called PS:. If in 

Step 34 of this manual you gave a 

structure name other than PS:, type the 

structure name you specified in place of 

PS: in the following steps. For 
example : 



1 I 

RESTORE (FROM) PS:<*>*.*.* (TO) FOO : 
< SYSTEM XMI) 

Notice the files are being restored to a 

structure called FOO: and the directory 
<SYSTEM>. 



Step 49: Give the DUMPER Command: RESTORE (TAPE FILES) PS :<*>*.*.* 
(TO) PS:<SYSTEM>*.*.*. 

To copy the TOPS-20 monitor and its related programs from magnetic 
tape to disk, give the DUMPER RESTORE command. Type RESTORE and press 
the ESC key. The system prints (TAPE FILES) . Type PS: and press the 
ESC key. The system prints <*>*.*.* (TO). Type PS:<SYSTEM> and press 
the ESC key. The system prints *.*.'*. Press the RETURN key. 

This DUMPER command restores all the files in the first save set to 
the directory PS:<SYSTEM>. When all the files are restored, the 
system prints END OF SAVESET and the DUMPER prompt: 

ISC) (ESC) (E|C) 

: i i 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <SYSTEM> * . * . *(R£D 

DUMPER TAPE # 1, "SYSTEM FILES FOR TOPS-20 V5", WEDNESDAY 5-MAR-82 2150 
LOADING FILES(S) INTO PS:<SYSTEM> 

END OF SAVESET 
DUMPER> 

The system prints a header containing the date and time that the tape 
was written. 

Error: If you do type the correct input structure, PS:, or if the 
tape is not positioned correctly, no files are restored from 
tape. In this case you will not see the message, LOADING 
FILE(S) INTO PS:<SYSTEM>. To correct this error, type 
CTRL/E, give the following commands, and begin again at Step 
49. 



(CTRUE ) 

4 

INTERRUPTING. . . 
DUMPER>REWIND (R|T) 

%DO YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND? 

YES OR NO? YESflfD 

DUMPER> 
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irror: If you do not type the correct structure and directory name, 
PS:<SYSTEM>, the files are restored to the wrong directory. 
To correct this error, type CTRL/E, give the following 
commands, and reissue the RESTORE command in this step. Be 
sure to delete and expunge the files in the incorrect 
directory. 



INTERRUPTING. . . 
DUMPER>SKIP (REtJ 

%DO YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND? 

YES OR NO? YES (RET) 

DUMPER> 

^Step 50: Give the DUMPER Command: RESTORE (TAPE FILES) PS :<*>*.*.* 
(TO) PS:<SUBSYS>*.*.*. 

Restore the system program files to the directory PS:<SUBSYS>. Type 
RESTORE and press the ESC key. The system prints (TAPE FILES) . Type 
PS: and press the ESC key. The system prints <*>*.*.* (TO). Type 
PS:<SUB and press the ESC key. The system prints SYS>*.*.*. Press 
the RETURN key. When all the files are restored, the system prints 
END OF SAVESET and the DUMPER prompt: 

(ESQ! (ESC) |E) 

T i I 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS:<SUBSYS> * . * . * (RET) 

DUMPER TAPE # 1, "SUBSYS FILES FOR TOPS-20 V5" , WEDNESDAY, 5-MAR-82 2153 
LOADING FILE(S) INTO PS:<SUBSYS> 

END OF SAVESET 
DUMPER> 

Error: If you do not type the correct input structure, PS: , or if 
the tape is not positioned correctly, no files are restored 
from tape. In this case you will not see the message 
LOADING FILE(S) INTO PS:<SUBSYS>. To correct this error, 
type CTRL/E, give the following commands, and begin again at 
Step 49 . 

fCTRlTE] 

INTERRUPTING. . . 
DUMPER>REWIND(RET) 

%DO YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND? 

YES OR NO? YES!® 

DUMPER> 



2-26 



CREATING THE TOPS-20 FILE SYSTEM 

Error: If you forget to type the directory PS:<SUBSYS>, the files 
are restored to the wrong directory. Type CTRL/E, give the 
following commands to correct the error, and reissue the 
RESTORE command in this step. Be sure to delete and expunge 
the files in the incorrect directory. 

INTERRUPTING. . . 
DUMPER>SKIP 0@U 

%D0 YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND? 

YES OR NO? YESdJ 

DUMPER> 

W^ Step 51: Give the DUMPER Command: RESTORE (TAPE FILES) PS:<*>*.*.* 
(TO) PS:<UETP.LIB>*.*.*. 

To restore the files into the directory <UETP.LIB>, type RESTORE and 
press the ESC key. The system prints (TAPE FILES) . Type PS: and 
press the ESC key. The system prints <*>*.*.* (TO). Type PS:<UETP.L 
and press the ESC key. The system prints IB>*.*.*. Press the RETURN 
key. When all the files are restored, the system prints END OF 
SAVESET and the DUMPER prompt: 

(S) fs§ Us) 

I I i 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <UETP . LIB>* . * . * (U 

DUMPER TAPE # 1, "UETP FILES FOR TOPS-20 V5" , MONDAY, 5-MAR-82 2013 
LOADING FILE(S) INTO PS : <UETP. LIB> 

END OF SAVESET 
DUMPER> 

Error: If you do not type the correct input structure, PS:, for 
example, or if the tape is not positioned correctly, no 
files are restored from tape. In this case you will not see 
the message LOADING FILE(S) INTO PS:<UETP.LIB> . To correct 
this error, type CTRL/E, give the following commands, and 
begin again at Step 49. 



pF L/F) 

INTERRUPTING. . . 
DUMPER>REWIND (H) 

%DO YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND? 

YES OR NO? YES (RE) 

DUMPER> 
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^ Step 52: Give the DUMPER Command: 
(TO) PS:<SUBSYS>*.*.* 



RESTORE (TAPE FILES) PS:<*>*. 



To restore the GALAXY files into the directory PS:<SUBSYS>, type 
RESTORE and press the ESC key. The system prints (TAPE FILES) . Type 
PS: and press the ESC key. The system prints <*>*.*.* (TO). Type 
PS:<SUB and press the ESC key. The system prints SYS>*.*.*. Press 
the RETURN key. When all the files are restored, the system prints 
END OF SAVESET and the DUMPER prompt. 



I 



DUMPER>RESTORE (TAPE FILES) PS:<*> 



* N* * * 



dp 
I 

(TO) PS:<SUBSYS>" 



DUMPER TAPE #1, "GALAXY V4 . SUBSYS FILES FOR TOPS-20 V5" 

TUESDAY, 5-OCT-81 2015 

LOADING FILE(S) INTO PS:<SUBSYS> 

END OF SAVESET 



Error : 



If you forget to type PS:<SUBSYS>, the system restores the 
files to the wrong directory. Type CTRL/E to stop DUMPER, 
give the SKIP command, and reissue the RESTORE command. 
Be sure to delete and expunge the files in the incorrect 
directory. 



[CTRL/ E ) 

INTERRUPTING. . . 
DUMPER>SKIP 0© 

%DO YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND? 

YES OR NO? YES© 

DUMPER> 



NOTE 

If you have an RP20 disk subsystem, 
perform Steps 53 through 55. Otherwise, 
continue the installation procedures at 
Step 56. 



W^ Step 53: Give the DUMPER Command: DUMPER>UNLOAD 



To remove the TOPS-20 Installation tape from the tape drive, type 
UNLOAD and press the RETURN key. The system rewinds the tape onto the 
source reel. 

DUMPER>UNLOAD(@[D 
DUMPER> 



^ Step 54: Remove the TOPS-20 Installation Tape and Physical 
the RP20 Microcode Tape on the Tape Drive. 



,junt 
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+ Step 55: 



Give the DUMPER Command: RESTORE (TAPE 
(TO) PS:<SUBSYS>*.*.* <RET> 



FILES) PS:<*>< 



To copy the RP20 Microcode from magnetic tape to disk give the DUMPER 

RESTORE command. Type RESTORE and press the ESC key. The system 

prints (TAPE FILES) . Type PS: and press the ESC key. The system 

prints <*>*.*.* (TO). Type PS:<SUB and press the ESC key. The system 
prints SYS>*.*.*. Press the RETURN key. 

ESC £sc) £E) 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <SUBSYS>* . * . * (RET) 

DUMPER TAPE #1, "RP20 DX20 MICROCODE FOR TOPS-20 V5", 

TUESDAY 5-OCT-1981 2200 

LOADING FILE(S) INTO PS:<SUBSYS> 

END OF SAVESET 
DUMPER> 

Error: If you do not type the correct structure and directory name, 
PS:<SUBSYS>, the files are restored to the wrong directory. 
To correct this error, type CTRL/E, give the following 
commands, and reissue the RESTORE command in Step 55. Be 
sure to delete and expunge the files in the incorrect 
directory. 



(ctrl/jO 
i 

INTERRUPTING. . . 
DUMPER>SKIP (HD 

%DO YOU REALLY WANT TO ABORT YOUR INTERRUPTED COMMAND? 

YES OR NO? YES (H) 

DUMPER> 



W^ Step 56: Type EXIT and Press the RETURN Key. 

Type EXIT and press the RETURN key to end DUMPER, 
the TOPS-20 enabled prompt: 



The system prints 



DUMPER> EXIT (RED 
$ 

^Step 57: Give the Command: UNLOAD (DEVICE) MTAO:. 

To remove the TOPS-20 Installation Tcipe or RP20 Microcode Tape from 
the tape drive, type UNLOAD and press the ESC key. The system prints 
(DEVICE). Type MTAO: and press the RETURN key. The system rewinds 
the tape onto the source reel. 



$UNLOAD (DEVICE) MTAO:® 
$ 

You can now remove the TOPS-20 Installation Tape from the tape drive, 
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Error: If the system prints: 

%Device open in lower fork 
%Kill lower fork? 

type YES and press the RETURN key. The system unloads your 
tape. 

^ Step 58: Give the Command: INFORMATION (ABOUT) DISK-USAGE (OF 
DIRECTORY) PS:<*> and Press the RETURN Key. 

If you give the command INFORMATION (ABOUT) DISK-USAGE (OF DIRECTORY) 
PS:<*>, the system will print the size of every directory on the 
public structure, PS:. The example below was obtained using a 
DECSYSTEM-20, model 2060. You will notice that there are two 
directories called <NEW-SYSTEM> and <NEW-SUBSYS> . These directories 
should have no files associated with them. They were created by the 
monitor and will be used in the event you update your system to a 
newer release of the TOPS-20 operating system. 

(ESC) Hg 

I i 

$INFORMATION (ABOUT) DISK-USAGE (OF DIRECTORY) PS :<*>(© 

PS : <ROOT-DIRECTORY> 

108 Pages assigned 

+INF Working pages, +INF Permanent pages allowed 

PS:<ACCOUNTS> 

14 Pages assigned 

+INF Working pages, +INF Permanent pages allowed 

PS:<NEW-SUBSYS> 

Pages assigned 

+INF Working pages, +INF Permanent pages allowed 

PS:<NEW-SYSTEM> 

Pages assigned 

+INF Working pages, +INF Permanent pages allowed 

PS:<OPERATOR> 

Pages assigned 

250 Working pages, 250 Permanent pages allowed- 

PS:<SPOOL> 

Pages assigned 

+INF Working pages, +INF Permanent pages allowed 

PS:<SUBSYS> 

2319 Pages assigned 

+INF Working pages, +INF Permanent pages allowed 

PS:<SYSTEM> 

5493 Pages assigned 

+INF Working pages, +INF Permanent pages allowed 

PS:<SYSTEM-ERROR> 

1 Pages assigned 

+INF Working pages, +INF Permanent pages allowed 
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PS:<UETP> 

Pages assigned 

100000 Working pages, 100000 Permanent pages allowed 

PS:<UETP.LIB> 

1740 Pages assigned 

4000 Working pages, 4000 Permanent pages allowed 

PS:<UETP.RUN> 

Pages assigned 

500 Working pages, 500 Permanent pages allowed 

Total of 9675 Pages assigned, in 12 directories. 
57943 Pages free on PS:, 18057 pages used. 

Error: If the "Pages assigned" for each directory shown do not 
approximately match the value shown in this manual or the 
value derived from the directory listing shipped with your 
Installation tape, some files may not have been copied 
correctly. Mount the tape again on MTA0 : , skip four files 
and begin again at Step 47. 

^Step 59: Give the Command: RUN (PROGRAM) PS: <SUBSYS>MAKDMP.EXE and 
Press the RETURN Key. 

To create the DUMP. EXE file, which records any system failures, type 
RUN and press the ESCAPE key. The system prints (PROGRAM) . Type 
PS:<SUBSYS>MAKDMP.EXE and press the RETURN key. The system prints the 
prompt MAKDMP> . 

(ESC) 
I 
$RUN (PROGRAM) PS : <SUBSYS>MAKDMP. EXE® 
MAKDMP> 

NOTE 

If you do not know how much memory your 
system has, type the HELP command and 
press the RETURN key after the system 
prints MAKDMP>. The system prints 
examples of physical memory size with 
the corresponding number of words. 

^Step 60: Give the MAKDMP Command: CREATE (DUMP FILE) 
PS:<SYSTEM>DUMP.EXE (MEMORY SIZE) Memory Size and Press the 
RETURN Key. 

To overwrite the existing DUMP. EXE file with a new DUMP. EXE file, type 
CREATE and press the ESCAPE key. The system prints (DUMP FILE) . Type 
PS:<SYSTEM>DUMP.EXE and press the ESCAPE key. The system prints (FOR 
MEMORY SIZE) . Type the total amount of memory your system has and 
press the RETURN key. In the following example 2048K words was the 
memory size. 

H§ (HE) 

1 I 

MAKDMP>CREATE (DUMP FILE) PS : <SYSTEM>DUMP . EXE (MEMORY SIZE) 2048® 
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t^ Step 61: Give the MAKDMP Command: EXIT and Press the RETURN Key. 

To exit the MAKDMP program and return to TOPS-20 command level, type 
EXIT and press the RETURN key. 

MAKDMP> EXIT (RET) 
$ 



NOTE 

If in the future you add some additional 
memory to your system, you should 
reconfigure the DUMP. EXE file to allow 
it to accomodate the additional memory. 
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CHAPTER 3 
TAILORING THE SYSTEM 



After you have installed the bundled TOPS-20 software from the 
Installation Tape, tailor your system for your specific needs. You 
must: 

1. Select a monitor that is correct for your system. 

2. Change the system name. 

3. Set terminal speeds; define remote lines, system logical 
names, magnetic tape drive parameters, line printer 
parameters, time zone, file archiving and migration recycle 
periods, and accounting shift parameters; and enable or 
disable directory parameter setting, account validation, 
class scheduling, working set swapping, latency optimization, 
and tape drive allocation. All these parameters are located 
in the system parameter file PS : <SYSTEM>5-1 -CONFIG.CMD. 

4. Change the operator's password and user group. 

5. Create the directory PS : <REMARKS> . 

6. Create the PS :<SYSTEM>LPFORM. INI file. 



3.1 SELECTING A TOPS-20 MONITOR 

At this time you are running the TOPS-20 monitor 2060-MONBIG.EXE. You 
should now select the monitor that most closely meets your system's 
requirements. Choose a monitor that supports at least: 

1. As much memory as your system contains. A monitor that 
supports less memory than your system contains will not use 
all available memory. 

2. The number of terminal lines you need. Do not count the 
operator's console in this number. Just count the local 
terminal lines and remote lines. 

3. The number of user jobs that you plan to run, plus two (one 
operator job and job 0) . For example, if you expect to run 
20 user jobs, the monitor you select should support at least 
22 jobs. 
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4. . The number of pseudo-terminals that you need. The system 

needs at least two pseudo-terminals, one to run the PTYCON 
program, which in turn usually runs the operator program OPR, 
and one for unplanned situations that may arise. For 
example, if you want to run five pseudo-terminals in your 
batch system, you need a monitor that supports at least seven 
pseudo- terminals. 

5. The number of peripheral devices on your system. 

All monitors are stored in the directory <SYSTEM>. They all run 
timesharing and batch concurrently. Do not select a moni'tor that has 
fewer resources than you need, or a monitor that is unnecessarily 
large. The TOPS-20 monitors and their characteristics are listed 
below. Refer to Table 3-1 for the maximum structure size. 

2060-MONBIG.EXE A large timesharing monitor. This monitor 

supports up to: 

100 jobs 

128 lines 

30 pseudo-terminals 

512K of memory 

8 magnetic tape drives 

2 1 ine pr inters 

1 card reader 

120 million words of disk storage (six RP04, 
three RP06, three PP20 spindles, or one 
RP07) per structure 
7000 pages for swapping space 

2060-MONMAX.EXE The largest timesharing monitor. This monitor 

supports up to: 

128 jobs 
128 lines 

50 pseudo-terminals 
2048K of memory 

16 magnetic tape drives 

2 1 ine pr inters 

1 card reader 

120 million words of disk storage (six RP04 
three RP06, three RP20 spindles, or one 
RP07) per structure 
10000 pages for swapping space 

AN-MONSML.EXE A small ARPANET timesharing monitor. This monitor 
supports up to: 

40 jobs 

64 1 ines 

20 pseudo-terminals 

2 NVT ' s 

2 56K of memory 

8 magnetic tape drives 

2 line printers 
1 card reader 

120 million words of disk storage (six RP04, 
three RP06, three RP20 spindles, or one 
RP07) per structure 
5035 pages for swapping space 
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AN-MONMED.EXE 



A medium-size ARPANET timesharing monitor, 
monitor supports up to: 



This 



60 

128 

30 

30 

256K 

8 

2 

1 

120 



7000 



jobs 

1 ines 

pseud o- terminals 

NVT's 

of memory 

magnetic tape drives 

line printers 

card reader 

million words of disk storage (six RP04, 

three RP06, three RP20 spindles, or one 

RP07) per structure 

pages for swapping space 



AN-MONBIG.EXE 



A large ARPANET timesharing monitor. This monitor 
supports up to: 

100 jobs 
128 lines 
30 pseudo-terminals 
4 NVT ' s 
512K of memory 

8 magnetic tape drives 
line printers 
card reader 

million words of disk storage (six RP04, 
three RP06, three RP20 spindles, or one 
RP07) per structure 
pages for swapping space 



2 

1 

120 



7000 



AN-MONLGE.EXE 



The largest ARPANET timesharing monitor, 
monitor supports up to: 



This 



100 

128 

50 

40 

2048K 

8 

2 

1 

120 



10000 



jobs 

1 ines 

pseud o- terminals 

NVT's 

of memory 

magnetic tape drives 

line printers 

card reader 

million words of disk storage (six RP04, 

three RP06, three RP20 spindles, or one 

RP07) per structure 

pages for swapping space 



Table 3-1 
Maximum Structure Size 



Type of 
Disk Drive 


Max. No. Packs 
Per Structure 


No. Pages 
Per Pack * 


RP04 
RP06 
RP07 
RP20 


6 
3 
1 
3 


38,000 

76,000 

216,376 

201,420 



* a page = 512 x 36 bit words 
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^Step 62: Give the Command: CONNECT (TO DIRECTORY) PS:<SYSTEM>. 

Connect to the PS:<SYSTEM> directory by typing CONNECT and pressing 
the ESC key. The system prints (TO DIRECTORY). Type PS:<SYSTEM> 
and press the RETURN key: 



$CONNECT (TO DIRECTORY) PS : <SYSTEM>dD 
$ 



^Step 63: Give the Command: COPY (FROM) montyp.EXE (TO) MONITR.EXE. 

Copy the monitor that you have selected to the file MONITR.EXE. 
Type COPY and press the ESC key. The system prints (FROM). Type 
the name of the monitor that you have selected and press the ESC 
key. The system prints the generation number and (TO). Type 
MONITR.EXE and press the RETURN key. 

QED ( tsc ) 

$COPY (FROM) montyp.EXE.l (TO) MONITR. EXEC^r) 
montyp.EXE.l => MONITR. EXE. 1 [OK] 



The different monitors are: 



TOPS-20 
2060/2040S 



TOPS-20 
ARPANET 



2060-MONBIG.EXE 
2060-MONMAX.EXE 



AN-MONSML.EXE 
AN-MONMED.EXE 
AN-MONLGE.EXE 
AN-MONBIG.EXE 



Error : 



If you type the wrong name, reissue the command. 



3.2 CHANGING THE SYSTEM NAME 



Whenever a 
INFORMATION 
similar to: 



user types CTRL/C before logging in or gives the 
(ABOUT) VERSION command, the system prints a message 



TOPS-20 SMALL SYSTEM, TOPS-20 MONITOR 5.1(5050) 

You can change the system name "TOPS-20 SMALL SYSTEM" by entering the 
name you want into the file PS : <SYSTEM>MONNAM.TXT . If the name 
contains lowercase letters, give the command TERMINAL (MODE IS) NO 
RAISE before entering the name. 

The text of the system name can contain up to 105 characters. For 
practical purposes, it should not exceed 32 characters to fit on a 
single 72-character line of terminal output. The following two steps 
show how to change the system name to "Installation-test System." 
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^Step 64: Give the Command: TERMINAL (MODE IS) NO RAISE. 

If you want lowercase letters in the system name, type TERMINAL and 
press the ESC key. The system prints (MODE IS). Type NO RAISE and 
press the RETURN key. Make sure the CAPS LOCKED button on the 
terminal is not depressed. The system prints $. 



$TERMINAL (MODE IS) NO RAISE ("ST) 
$ 

^Step 65: Give the Command: COPY (FROM) TTY: (TO) MONNAM.TXT<RET> 
type-system-name-here "Z. 

Type COPY and press the ESC key. The system prints (FROM). Type TTY: 
and press the ESC key. The system prints (TO). Type MONNAM.TXT and 
press the RETURN key. The system is now waiting for you to type the 
new name of your system. After you enter the new system name, press 
the RETURN key; then type a CTRL/Z . The system prints "Z, followed 
by the $ prompt. In the example below, we use Installation-test 
System as the new system name. 

C esQ CUD 

\ \ / _^ 

$COPY (FROM) TTY: (TO) MONNAM. TXT CkD 
TTY: => MONNAM.TXT. 1 

Inst allation --test System C**T) 

(Vtrl/z) 



J 

"z 

$ 

You can change this file at any time, but the system reads the system 
name only when the monitor is started (whenever you boot the system) . 

^Step 66: Give the Command: COPY (FROM) TTY: (TO) TAPNAM.TXT<RET> 
type-short-system-name-here "z. 

You should also change the system name that will be written on the 
volume header label of any tape initialized by users of the system. 
Do this by entering the name you want into the file 
PS:<SYSTEM>TAPNAM.TXT. This system name must contain ten or fewer 
characters, so you will probably have to abbreviate the name given in 
the previous step. The following step shows how to change the system 
name appearing on tape labels written by the system to "Instal-tst" . 

\ \ 



$COPY (FROM) TTY: (TO) TAPNAM.TXT C^") 
TTY:=> TAPNAM.TXT. 1 

Instal-tst Chl) 
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| 3.3 CREATING SYSTEM DEFAULTS IN 5-1-CONFIG.CMD 

| You must create the file PS :<SYSTEM>5-l-CONFIG.CMD to define system 
parameters for: 

• Terminal line speeds 

• Logical names 

• Magnetic tape drives 

• Line printers 

• Local time zone 

• Directory parameter setting 

• Account validation 

• Performance improvements 

• Scheduler controls 

• File archiving and migration 

• Tape drive allocation 

• Accounting shift changes 

The next time the system starts, the SETSPD (SET System Parameter 
Defaults) program uses the parameters entered into this file. This 
program runs automatically at system startup. 

The formats of the commands are described in Sections 3.3.1 through 
3.3.13. You may include comment lines if they are preceded by 
exclamation points. 

^Step 67: Give the Command: CREATE (FILE) 5-1-CONFIG.CMD. 

| Use EDIT to create the 5-1-CONFIG.CMD file. (Refer to the TOPS-20 
EDIT Reference Manual for more information on how to use EDIT.) To 
create the file 5-1-CONFIG.CMD, type CREATE and press the ESC key. 
The system prints (FILE). Type 5-1-CONFIG.CMD and press the RETURN 
key. The system prints Input: 5-1-CONFIG.CMD. 1 and line number 
00100: 

SCREATE (FILE) 5-1-CONFIG. CMDCmD 

Input: 5-1-CONFIG. CMD.l 

00100 

Do not confuse the CREATE command, which creates a file, with the 
CTRL/E CREATE command, which creates a directory. 



3.3.1 Setting Terminal Speeds 

Whenever the system starts, the SETSPD program reads the TERMINAL 
commands from PS : <SYSTEM>5-l-CONFIG. CMD and sets the terminal lines to 
the specified speeds. 
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Users can change the speeds of their terminals by giving the TERMINAL 
(MODE IS) SPEED command. When one user logs out and another user logs 
in on the same terminal, the system does not change the line speed 
back to the default listed in 5-1-CONFIG.CMD. 

However, if the line is defined as REMOTE, the speed is changed back 
after the line is disconnected. 

The operator can change the speed of the line by giving the CTRL/E SET 
command . 

To set the default speed for a particular line, enter a command in the 
following format into 5-1-CONFIG.CMD: 

TERMINAL line SPEED input output 

Item Identifies 

line An octal line number, or a range of lines in the form 
line-line. Your DIGITAL Field Service Representative 
will provide you with a list of line numbers and the 
corresponding locations. (Refer to Section 1.2.) 

input The input (to the system) speed of the terminal (s). 

output The output speed of the terminal (s). If you do not 
specify an output speed along with an input speed, the 
system assumes that the output speed is the same as the 
input speed. 

Valid terminal speeds are: 






(to shut off the line) 


300 


50 




600 


75 




1200 


110 




1800 


134 


(actually 134.5) 


2400 


150 




4800 


200 




9600 



NOTE 

If you do not specify a speed for a 

line, the system uses 300 for both input 

and output. If you have lines in the 

terminal controller (the DH11) that are 

not installed, you should define those 

lines with a speed of 0. Otherwise, the 
lines run open, causing degradation in 
system performance. 
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Line numbers are always octal, and the console terminal line number is 
always one greater than the highest line number. Refer to Table 3-2, 
below, for line numbers for the DECSYSTEM-20. 



Table 3-2 
Terminal Line Numbers 
DECSYSTEM-20 



Number of Lines 
(Decimal) 



Timesharing Line 
Numbers (Octal) 



Console Line 
Number (Octal) 



8 
16 
32 
64 
96 



1 to 10 

1 to 20 

1 to 40 

1 to 100 

1 to 140 



11 

21 

41 

101 

141 



^Step 68: Type the TERMINAL SPEED Commands. 

Type your required TERMINAL SPEED commands. You can include comment 
lines by preceding each of them with an exclamation point. The file 
entered below is an example. Determine the most useful definitions 
for the system according to the terminals that you have. 



00100 ! Terminal Speeds CST) 

00200 ! Line 1 has input = 9600 and output=9600 C^T) 

00300 TERMINAL 1 SPEED 9 6 00 C™T) 

00400 ! Lines 2 to 20 have inp ut a nd output=2400 GjjjT) 

00500 TERMINAL 2-20 SPEED 2400<jkD 

00600 ! Lines 23 to 40 do not exist C^D 

00700 TERMINAL 23-40 SPEED OQiD 

00800 



3.3.2 Defining Dial-Up (Remote) Lines 

For each dial-up line, you have the option of declaring that line to 
have a specified speed or you may declare a line to be autobaud. If a 
dial-up line is declared an autobaud line, at system startup the line 
will be automatically set to 300 baud. 

To declare a line autobaud, replace the word SPEED with the word AUTO 
in the TERMINAL command and do not specify any input and output 
speeds . 
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Include a TERMINAL command for each dial-up line. Use the same form 
as described above, but insert the word REMOTE after the line number. 
If you do not use the AUTO argument and omit the output speed, the 
system assumes that the output speed is the same as the input speed. 
The command format is: 



TERMINAL line REMOTE SPEED input output 



or 



TERMINAL line REMOTE AUTO 



Whenever a user starts a job on a dial-up line, and AUTO has not been 
specified, the system sets the speed of that line to the speed 
specified in 5-1-CONFIG.CMD. 



^Step 69: Define REMOTE Lines. 



If you have remote lines, obtain the line numbers from your DIGITAL 
Field Service Representative and enter the proper commands in 
5-1-CONFIG.CMD. The lines entered below are only an example. You 
must determine the correct commands for your own system. 

00800 ! Lines 21 and 22 are dialup lin es CST ) 
00900 TERMINAL 21 REMOTE SPEED 300 (jET) 
01000 TERMINAL 22 REMOTE AUTO (~SD 



3.3.3 Defining System Logical Names 

Insert a command in the following format to define any special system 
logical names that you require. These logical names are defined when 
the system starts. The command format is: 

DEFINE name definition-list 

The logical name SYS: defaults to PS:<SUBSYS> if you do not define it 
in 5-1-CONFIG.CMD. The TOPS-20 User's Guide describes logical names. 



^Step 70: Type System Logical Name Definitions. 

Enter any system logical name definitions into 5-1-CONFIG.CMD. The 
lines entered below are examples. You must determine the correct 
definitions for your own system. 

01100 
01200 
01300 
01400 
01500 



DEFINE NEW: PS:<NEW>,SYS 

DEFINE OLD: PS : <OLD> , SYS : (~5JT) 

DEFINE HLP: SYS : CsD 

DEFINE SERR: PS : <SYSTEM-ERROR> C^r 



3.3.3.1 Selecting an Editor - You have the option of selecting the 
default editing program (editor) with which your users create and edit 
files using the CREATE and EDIT commands. If you want them to use TV, 
enter the command, DEFINE EDITOR: SYS:TV.EXE into the 5-1-CONFIG.CMD 
file. If you do not put this command into the 5-1-CONFIG.CMD file, 
the default editor used for the CREATE and EDIT commands will be the 
EDIT program. 
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By defining logical name EDITOR: for their own jobs, users can 
override your choice of default editor, as long as the editor they 
specify is available at your installation. The following step is an 
example of making TV the default editor for your installation. 

Step 71: Type DEFINE EDITOR: SYS:TV.EXE and Press the RETURN Key. 

If you are using the TV editor as your system's default editor, type 
DEFINE EDITOR: SYS:TV.EXE and press the RETURN key. 

01500 DEFINE EDITOR: SYS :TV. EXF C^Q 
01600 



NOTE 

If you want your system's default editor 
to be the EDIT program, do not put any 
DEFINE EDITOR: command into the 
5-1-CONFIG.CMD file. 



3.3.4 Defining Magnetic Tape Logical Unit Numbers 

The system assigns logical unit numbers to magnetic tape drives. It 
starts with the lowest numbered unit on the lowest numbered controller 
on the lowest numbered channel, and proceeds upward. If the cabling 
connecting the tape drives to the system changes, the logical unit 
numbers referencing the tape drives can also change, unless you enter 
the appropriate commands in 5-1-CONFIG.CMD. The commands in 
5-1-CONFIG.CMD guarantee that the physical drives always have the same 
logical unit numbers. 

Request the tape drive serial numbers from your DIGITAL Field Service 
Representative, or open the back door of the magnetic tape drives and 
look on the sticker containing the number. Use the last four digits 
of the number. Enter a MAGTAPE command in the following format into 
the 5-1-CONFIG.CMD file: 

MAGTAPE unit serial slave 

Item Identifies 

unit The logical unit number that you wish to assign to 
the drive. The unit number can be 0, 1, 2, 3, 4, 
5, 6 , or 7 . 

serial The last four digits of the serial number. 
(Leading 0s may be omitted.) 

slave The type of tape drive, e.g., TU72, TU45, TU77, 
TU78. 

NOTE 

If no slave number is entered, the 
system assumes that the slave number is 
TU45. 
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Step 72: Define Magnetic Tape Drive Logical Unit Numbers. 

Enter the definitions of the magnetic tape drive logical unit numbers 
into 5-1-CONFIG.CMD. The commands entered below are only examples. 
You must determine the correct definitions for your system. 



01600 
01700 
01800 
01900 
02000 
02100 



MAGTAPE 24 

MAGTAPE 1 2 001 

MAGTAPE 2 2 002 

MAGTAPE 3 20 3 

MAGTAPE 4 1500 



TU4 5l 
TU77< _ 
TU71 C^p 
TU70 CST) 

TU7 2< 



3.3.5 Defining Line Printer Parameters 

The characteristics of the six possible line printers that can be 
ordered with your DECSYSTEM-20 are listed in Table 3-3, below. Ask 
your DIGITAL Field Service Representative which type of line printer 
you have. 



Table 3-3 
DECSYSTEM-20 Line Printers 



Model 


VFU 


Lowercase 


Identification 


LP20A 


PROGRAMMABLE 


NO 


Four buttons on the 


LP20B 


PROGRAMMABLE 


YES 


right top panel, with 
the top button being 
POWER ON ALARM/CLEAR 


LP20C 


PROGRAMMABLE 


NO 


Four buttons on the 


LP20D 


PROGRAMMABLE 


YES 


right top panel, with 
the top button being 
POWER ON ALARM/CLEAR 


LP20F 


TAPE 


NO 


Four rocker switches on 


LP20H 


TAPE 


YES 


the left of the top 
panel 



Sections 3.3.5.1 and 3.3.5.2 describe how to install the line printer, 
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3.3.5.1 Specifying the VFU File - The VFU (vertical formatting unit) 
is used to control paper advance through the line printer. For a line 
printer with a programmable VFU, place a command in 5-1-CONFIG.CMD 
that specifies the file to program the VFU. For installation 
purposes, use SYS : NORMAL. VFU. The command format is: 



PRINTER n LOWERCASE VFU dev : <d ir >name . typ 



Item 

n 

LOWERCASE 



Identifies 

The unit number of the printer. 

The printer has the 96-character 
set. If your printer has the 
64-character set, do not include 
the word LOWERCASE in the command. 



VFU 



dev:<dir>name.typ 



The type of file specified by the 
command . 

The location of the VFU file. 



You do not need VFU commands for LP20F and LP20H line printers. 
J Examples of typical VFU commands in the 5-1-CONFIG.CMD file are: 



For an LP20A and LP20C 
PRINTER VFU SYS : NORMAL . VFU 

For an LP20B and LP20D 

PRINTER LOWERCASE VFU SYS :NORMAL . VFU 



^Step 73: Type the VFU Command. 

If you have one or more line printers with programmable VFUs , enter 
the appropriate PRINTER commands in 5-1-CONFIG.CMD: 



02100 
02200 
02300 



PRINTER LOWERCASE VFU SYS : NORMAL .VFU C^T) 
PRINTER 1 VFU SYS : NORMAL .VFU C^F ) 



3.3.5.2 Specifying the RAM File - You must identify a file that will 
load the translation RAM (random-access memory). This RAM controls 

the way in which each character is treated by the line printer. Use 

SYS:LP96.RAM for line printers that have lowercase letters. Use 

SYS:LP64.RAM for printers that do not have lowercase letters. The 
command format is: 

PRINTER n LOWERCASE RAM dev : <d ir>name . typ 
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Item Identifies 

n The line printer unit number. 

LOWERCASE The printer has the 96-character 

set. If your printer has the 
64-character set, do not include 
the word LOWERCASE in the command. 

RAM The type of file specified by the 

command . 

dev: <d ir>name. typ The file that contains the 

translation RAM. 

Examples of typical RAM commands in the 5-1-CONFIG. CMD file are: 

For an LP20A, LP20F or LP20C 
PRINTER RAM SYS:LP64.RAM 

For an LP20B, LP20H or LP20D 
PRINTER LOWERCASE RAM SYS:LP9 6.RAM 

^Step 74: Type the RAM Command. 

Enter the RAM command into 5-1-CONFIG. CMD: 

02300 PRINTER LOWERCASE RAM SYS ;LP9 6 . RAM pST) 

02400 PRINTER 1 RAM SYS : LP64 . RAM C^D 

02500 



3.3.6 Defining the Local Time Zone 

The time zone in which your installation is located can be represented 
as the number of hours west or east of Greenwich. For example, 
Eastern Standard Time is zone 5; Central Standard Time is zone 6; 
Mountain Standard Time is zone 7; and Pacific Standard Time is zone 
8. To set your local time zone, you can enter the following command 
in 5-1-CONFIG. CMD: " | 

TIMEZONE n 

where n is a decimal number between -12 and 12 inclusive. Zones -12 
and 12 represent the same clock time but on opposite sides of the 
international date line. If you do not specify a time zone in 
5-1-CONFIG. CMD, the time zone will default to zone 0, signifying | 
Greenwich mean time. 

^Step 75: Type the TIMEZONE Command. 

Enter the TIMEZONE command into 5-1-CONFIG. CMD: | 

02500 TIMEZONE 5 GeD 
02600 
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3.3.7 Directory Parameter Setting 

You have the option of allowing users to change their directory 
parameters. If you decide to allow users to do this, no command is 

| entered into the 5-1-CONFIG. CHD file, because the system default is: 
ENABLE DIRECTORY-PARAMETER-SETTING. However, if you decide not to 
allow users to change their directory parameters, you should enter the 

| command: DISABLE DIRECTORY-PARAMETER-SETTING into the 5-1-CONFIG. CMD 
file. When this command is given, it prevents the user from changing 
any of his directory parameters unless he has WHEEL or OPERATOR 
capabilities. The following step is an example of disallowing users 
from changing their directory parameters. 

^Step 76: Type DISABLE DIRECTORY-PARAMETER-SETTING and Press the 
RETURN key. 

To prevent users from changing their directory parameters, type 
DISABLE DIRECTORY-PARAMETER-SETTING and press the RETURN key. 

02600 DISABLE DIRECTORY-PARAMETER-SETTING (jST) 
02700 

NOTE 

If the default is taken, users are 

allowed to change some of their 

directory parameters with the SET 
DIRECTORY commands. 



3.3.8 Account Validation 

You have the option of requiring all users to enter a valid account 
name when they are logging in to the system. If you decide to require 
valid accounts, you do not have to enter any command into the 

| 5-1-CONFIG. CMD file, because the system default is: ENABLE 
ACCOUNT-VALIDATION. However, if you decide not to validate accounts, 
you must enter the command DISABLE ACCOUNT-VALIDATION into the 

1 5-1-CONFIG. CMD file. The following step is an example of not using 
the account validation facility. 

^Step 77: Type DISABLE ACCOUNT-VALIDATION and Press the RETURN Key. 

If you are not validating accounts, type DISABLE ACCOUNT-VALIDATION 
and press the RETURN key. 

02700 DISABLE ACCOUNT-VALIDATION C^T) 
02800 



3.3.9 Performance Improvements 

Sections 3.3.9.1 and 3.3.9.2 discuss full latency optimization and 
working set swapping, respectively. 
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3.3.9.1 Full Latency Optimization - When the command, ENABLE 
FULL-LATENCY-OPTIMIZATION is entered into the 5-1-CONFIG. CMD file, the | 
number of revolutions needed to read pages off the disk is minimized. 

NOTE 

Before you can use this performance 
feature, you must obtain from your 
DIGITAL Field Service Representative the 
following information about your 
hardware. 

1. If you have a KL10-E processor, it 
must be at revision level 3. 

2. If you have board M7772, it must be 
at version level E and CS revision 
level F; or you may have board 
M7786. 

If your hardware does not meet the above 
requirements, take the system default, 
which is DISABLE FULL-LATENCY- 
OPTIMIZATION. 

^Step 78: Type ENABLE FULL-LATENCY-OPTIMIZATION and Press the RETURN 
Key. 

If your hardware meets the above requirements, type ENABLE 
FULL-LATENCY-OPTIMIZATION and press the RETURN key. 

02800 ENABLE FULL-LATENCY-OPTIMIZATION C^~) 
02900 



3.3.9.2 Working Set Swapping - If the command, ENABLE WORKING-SET- 
PRELOADING, is entered in the 5-1-CONFIG. CMD file, the entire working 
set of a process is brought into memory at once when it is the 
process's turn to run. Otherwise, this action occurs on a 
page-by-page basis. 

NOTE 

You should enable working set swapping 
only if your system runs large 
compute-bound jobs. However, if your 
system runs many interactive jobs or if 
you are unsure which description better 
fits your system, take the system 
default, which is: 

DISABLE WORKING-SET-PRELOADING 

^Step 79: Type ENABLE WORKING-SET-PRELOADING and Press the RETURN Key. 

02900 ENABLE WORKING-SET-PRELOADING (jST) 
03000 
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3.3.10 Scheduler Controls 

Sections 3.3.10.1 and 3.3.10.2 describe bias controls and class 
scheduling, respectively. 



3.3.10.1 Bias Controls - You have the option of deciding how your 
system's CPU time is to be divided between interactive and batch jobs. 
You do this by entering the command, BIAS n, into the 5-1-CONFIG. CMD 
file, where n is any integer between 1 and 20. The smaller the value 
of n, the larger the percentage of CPU time that is given to 
interactive jobs. If you do not give this command, a default value of 
11 will be taken, calling for equal division of time between 
interactive and batch jobs. 

^Step 80: Type the BIAS n Command. 

The example below shows how to enter a BIAS n command with a value of 
6, which favors interactive jobs. You must determine the correct 
value of n for your own system. 



03000 BIAS 6( mt 
03100 



3.3.10.2 Class Scheduling - You can use class scheduling to divide 
your system's CPU time among different classes of jobs. Class 
scheduling assigns percentages of CPU time to jobs according to their 
account number or according to a policy program written especially for 
your site. 

NOTE 

If you do not want to use class 
scheduling, you do not have to enter any 
command into the 5-1-CONFIG. CMD file, 
because the system default is: DISABLE 
CLASS-SCHEDULING. 

If you use either kind of class scheduling you can allocate any unused 
CPU time (windfall) among active jobs, or withhold it from all jobs. 
The command for enabling class scheduling using a policy program and 
allocating windfall is: ENABLE CLASS-SCHEDULING POLICY-PROGRAM 
ALLOCATED. The command for enabling class scheduling using a policy 
program and withholding windfall is: ENABLE CLASS-SCHEDULING 
POLICY-PROGRAM WITHHELD. If you enable class scheduling using a 
policy program, you cannot also enable class scheduling using 
accounts, and should skip to Section 3.3.11 after giving one of these 
two commands. 

If you do not have a policy program to use with class scheduling at 
your site, you can still enable class scheduling by assigning jobs to 
classes according to the account under which each job is running. 
(Refer to Chapter 6 of the TOPS-20 System Manager's Guide for 
information about associating accounts with particular classes.) To 
do this you must first enter commands into the 5-1-CONFIG. CMD file, 
specifying the percentage of CPU time that is to be given to jobs in 
each class. 
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The command, CREATE 1 .20, specifies that jobs running under accounts 
in class 1 are to be given a total of 20% of your system's CPU time. 
You must enter a CREATE command for each class that your system will 
use, with a different percentage for each class. The sum of the 
percentages you specify must not add up to more than 100%, although 
they may add up to less than 100%. If they add up to less than 100%, 
the percentage of CPU time that is not assigned becomes part of the 
system's windfall. The following commands are an example of dividing 
up 75% of the system's CPU time among three classes of jobs. You must 
supply the correct class numbers and percentages for your own system. 

^Step 81: Enter CREATE Commands for Scheduler Classes. 

Enter CREATE commands for your system's classes into 5-1-CONFIG.CMD. 

03100 CREATE 1 .20GsD 

03200 CREATE 2 .40QfD 

03300 CREATE 3 . 1 5 CsD 
03400 

Batch jobs can be put into a special class of their own by including 
the BATCH-CLASS n command, where n is the number of the class you 
choose for batch jobs. If you do not enter a BATCH-CLASS command, 
batch jobs are given CPU time according to the class associated with 
the account of the job's owner at the time of submission. The 
following commands are an example of creating a class for batch jobs 
and assigning 25% of CPU time to this class. 

^Step 82: Enter the BATCH-CLASS n Command and Assign a Percentage to 
This Class. 



03400 BATCH-CLASS 4 (jST) 
03500 CREATE 4 . 2 5 C^D 
03600 

Now you must enter the command that enables class scheduling using 
accounts. You must also decide whether to allocate any windfall CPU 
time to the jobs that are running or to withhold this windfall. The 
default for this command is ALLOCATED. It is recommended that you 
take this default. 

^Step 83: Type ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED and Press 
the RETURN Key. 

Now you actually enable class scheduling by giving the following 
command . 



03600 ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED (St 
03700 



CAUTION 

Do not enter the above command into the 
5-1-CONFIG.CMD file until you have 
entered the commands shown in this 
section that create scheduler classes. 
If you enable class scheduling before 
creating classes, class scheduling will 
not function properly. 
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3.3.11 File Archiving and Migration Parameters 

Sections 3.3.11.1 and 3.3.11.2 describe tape recycle periods for use 
with the file archiving and migration features. 



3.3.11.1 Archive Tape Recycle Period - TOPS-20 provides a feature 
that allows off-line storage of selected files on magnetic tape for 
long periods of time. You can specify for how long these files are 

j saved by inserting a command into the 5-1-CONFIG.CMD file stating, in 
days, the recycle period of the tapes. For example, to save archival 
files on tape for five years, you would enter the command, 
ARCHIVE-TAPE-RECYCLE-PERIOD 1825 (because 5 years x 365 days/year = 
1825 days) . If you do not insert an ARCHIVE-TAPE-RECYCLE-PERIOD 

| command in the 5-1-CONFIG.CMD file, a default value of 3650 (ten 
years) will be taken. 

^Step 84: Type the ARCHIVE-TAPE-RECYCLE-PERIOD n Command. 

The example below shows how to enter an ARCHIVE T TAPE-RECYCLE-PERIOD n 
command with a value of 1825 (five years) . You must determine a 
suitable value of n for your own system. 



03700 ARCHIVE-TAPE-RECYCLE-PERIOD 1825 dH 
03800 



3.3.11.2 Migration Tape Recycle Period - TOPS-20 provides a feature 
that, allows automatic off-line storage of old or little-used files on 
magnetic tape for short periods of time. You can specify for how long 
these files are saved by inserting a command into the 5-1-CONFIG.CMD 
file stating, in days, the recycle period of the tapes. For example, 
to save migrated files on tape for three months, you would enter the 
command, TAPE-RECYCLE-PERIOD 90 (because 3 months x 30 days/month 
90 days) . If you do not insert a TAPE-RECYCLE-PERIOD command in the 
5-1-CONFIG.CMD file, a default value of 180 (six months) will be 
taken. 



^Step 85: Type the TAPE-RECYCLE-PERIOD n Command. 



The example below shows how to enter a TAPE-RECYCLE-PERIOD n command 
with a value of 90 (three months) . You must determine a suitable 
value of n for your own system. 



03800 
03900 



TAPE-RECYCLE-PERIOD 9 CsD 



3.3.12 Tape Drive Allocation 

Sections 3.3.12.1 and 3.3.12.2 describe putting tape drive allocation 
into effect, and specifying a response to certain error conditions. 
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3.3.12.1 Enabling Tape Drive Allocation - TOPS-20 provides for the 
automatic assignment of tape drives to users who wish to read or write 
magnetic tapes. In order to use this feature, which also allows your 
system to read and write the labels of standard labeled tapes, you 
must insert the command, ENABLE TAPE-DRIVE-ALLOCATION into the 
5-1-CONFIG.CMD file. If you do not give this command, your users must 
assign tape drives with the TOPS-20 ASSIGN command and their labeled 
tapes will be treated as unlabeled tapes. 

^Step 86: Type the ENABLE TAPE-DRIVE-ALLOCATION Command. 

To allow labeled tape processing and the automatic assignment of tape 
drives, type ENABLE TAPE-DRIVE-ALLOCATION and press the RETURN key. 



03900 ENABLE TAPE-DRIVE-ALLOCATION C^t 
04000 



3.3.12.2 Treatment of Unrecognized Tapes - If you enabled tape drive 
allocation in the previous step, you must decide what action the 
system should take if a labeled tape is mounted improperly, for 
example, the user specifies the wrong label type or density. If you 
want the system to unload the tape so that it cannot be accidentally 
erased, you must insert the command, TAPE-RECOGNITION-ERRORS UNLOAD, 
into the 5-1-CONFIG.CMD file. If you do not give this command, the 
system will treat improperly mounted labeled tapes as unlabeled tapes 
and will continue processing them. That is, the system default is 
TAPE-RECOGNITION-ERRORS REGARD-AS-UNLABELED. 

^Step 87: Type the TAPE-RECOGNITION-ERRORS UNLOAD Command. 

To force the automatic unloading of any tapes that are improperly 
mounted, type TAPE-RECOGNITION-ERRORS UNLOAD and press the RETURN key. 

04000 TAPE-RECOGNITION-ERRORS UNLOAD C^JT ) 
04100 



3.3.13 Accounting Shift Changes 

The accounting facility allows you to provide varied billing rates for 
system use at different times. You do this by entering commands into 
the 5-1-CONFIG.CMD file specifying the time of day for each rate 
change. You should give one command for each time the rate changes. 
Use days of the week or keywords WEEKDAYS, WEEKENDS, and ALL, and 
times in either 24-hour or AM/PM format. (Refer to Chapter 6 of the 
TOPS-20 System Manager's Guide for detailed information about 
accounting shift changes.) The example below allows special rates for 
evenings and weekends. You must provide the correct days and times 
for your own system. 
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^Step 88: Enter CHANGE Commands for Accounting Shift Changes. 



04100 CHANGE 9:00 WEEKDAYS 

04200 CHANGE 17:00 WEEKDAYS 

04300 CHANGE 0:00 SATURDAY 
04400 

NOTE 

You do not have to enter CHANGE commands 
| into the 5-1-CONFIG.CMD file. If you do 

not enter any CHANGE commands, the 
accounting shift change feature of 
system accounting is not used. 

^Step 89: Press the ESC Key, Type EU and Press the RETURN Key. 

I When you have finished creating the 5-1-CONFIG.CMD file, press the ESC 
key to end insert mode. Type EU and press the RETURN key to save the 
file. The system prints the filename and $: 

GE) 

I 

04400 $ 

*euCmD 
| [5-1-config.cmd. 1] 

$ 

I^Step 90: Give the Command: TYPE (FILE) <SYSTEM>5-l-CONFIG.CMD. 

To be sure that the file is in the proper directory, type TYPE and 
press the ESC key. The system prints (FILE) . Type 
| PS:<SYSTEM>5-l-CONFIG.CMD and press the RETURN key. The system prints 
system prints the contents of the file on your terminal. 

CiD 
I 

I $TYPE (FILE) PS :<SYSTEM> 5-1 -CONFIG. CMP C^T) 

! Terminal Speeds 

! Line 1 has input=9600 and output=9600 
TERMINAL 1 SPEED 9600 ! Burke's line 

! Lines 2 to 20 have input and output=2400 
TERMINAL 2-20 SPEED 2400 

! Lines 23 to 40 are shut off 
TERMINAL 23-40 SPEED 

! Line 21 and 22 are dialup lines 

TERMINAL 21 REMOTE SPEED 300 

TERMINAL 22 REMOTE AUTO 

DEFINE NEW: PS : <NEW> , SYS : 

DEFINE OLD: PS : <OLD> , SYS : 

DEFINE HLP: SYS: 

DEFINE SERR: PS : <SYSTEM-ERROR> 

MAGTAPE 24 TU4 5 

MAGTAPE 1 2001 TU77 

MAGTAPE 2 2002 TU71 

MAGTAPE 3 2003 TU70 

MAGTAPE 4 150000 TU72 
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PRINTER VFU SYS : NORMAL. VFU 

PRINTER 1 VFU SYS : NORMAL . VFU 

PRINTER LOWERCASE RAM SYS:LP9 6.RAM 

PRINTER 1 RAM SYS:LP64.RAM 

TIMEISONE 5 

ENABLE FULL-LATENCY-OPTIMIZATION 

ENABLE WORKING-SET-PRELOADING 

BIAS 6 

CREATE 1 .20 

CREATE 2 .40 

CREATE 3 .15 

BATCH-CLASS 4 

CREATE 4 .25 

ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED 

ARCHIVE-TAPE-RECYCLE-PERIOD 182 5 

TAPE-RECYCLE-PERIOD 90 

ENABLE TAPE-DRIVE-ALLOCATION 

TAPE-RECOGNITION-ERRORS UNLOAD 

CHANGE 9:00 WEEKDAYS 

CHANGE 17:00 WEEKDAYS 

CHANGE 0:00 SATURDAY 

$ 

Remember, the file shown above is just an example. 

Error: If the system cannot find the file or prints the wrong file, 
give the following COPY command to place the file in 
<SYSTEM>: 



$COPY (FROM) 5-1-CONFIG.CMD (TO) PS : <SYSTEM> 5-1 -CONFIG . CMP C^D | 

(Refer to the TOPS-20 EDIT Referenc e Manual if you want to 
change the file.) 



3.4 CHANGING THE OPERATOR'S PASSWORD AND USER GROUP 

You may wish to change the operator's password from the widely 
publicized DEC-20 to a 39-alphanumer ic-character phrase of your 
choosing. The password can include a hyphen. Be sure to remember the 
password or you will have to reinstall the system if you cannot think 
of the particular password that you typed. 

Also, in order for the operator to run the User Environmental Test 
Package, he must belong to the correct user group. This section 
describes how to change the operator's password and user group. 

^Step 91: Give the Command: "ECREATE (DIRECTORY NAME) PS : <OPERATOR> 
and Press the RETURN Key. 

Type CTRL/E CREATE, and press the ESC key. The system prints 
(DIRECTORY NAME). Type PS : <OPERATOR> and press the RETURN key. The 
system prints [OLD], and then the subcommand prompt $$. 



1 \ 

$"ECREATE (DIRECTORY NAME) PS : <OPERATOR>G|t 

[OLD] 
$$ 
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^Step 92: Give the Command: PASSWORD Your Password and Press the 
RETURN Key. 

To insert the operator's new password, type PASS and press the ESC 
key. The system prints WORD. Type the new password and press the 
RETURN key. The system prints the subcommand prompt. 

(JED 
i 

$$PASSWORD your password (j^£2J 
$$ 

^Step 93: Give the Subcommand: USER-GROUP (NUMBER) 100 and Press the 
RETURN Key. 

The operator must be a member of user group 100 in order for him to 
run the User Environmental Test Package. Type USER-GROUP and press 
the ESC key. The system prints (NUMBER). Type 100 and press the 
RETURN key. 

(JED 

$$USEP-GROUP (NUMBER) 1 00 C^D 
$$ 

Error: If you see a message similar to: %Group already exists, you 
can ignore this message. The operator is already a member 
of the correct user group. Go to Step 95. 

^Step 94: Give the Subcommand: IPCF (CAPABILITY) and Press the RETURN 
Key. 

The operator must have IPCF capabilities in order to run the User 
Environmental Test Package. Type IPCF and press the ESCAPE key. The 
system prints (CAPABILITY). Press the RETURN key. 

(JED 

\ 
$$IPCF (CAPABILITY) C^T) 

$$ 

^Step 95: Press the RETURN Key. 

To return to the TOPS-20 command level, press the RETURN key. 

$$(JJD 
$ 



3.5 CREATING PS:<REMARKS> DIRECTORY 

The directory PS:<REMARKS> is used to receive messages sent by users 
to the operator. Creating this directory avoids constant interruption 
to the operator from users issuing PLEASE requests. With this 
directory the operator can read the messages at a specified time each 
day. 
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^Step 96: Give the Command "ECREATE (DIRECTORY NAME) PS:<REMARKS> and 
Press the RETURN Key. 

Type CTRL/E CREATE, and press the ESC key. The system prints 
(DIRECTORY NAME). Type PS:<REMARKS> and press the RETURN key. 

(l I HI, I. ) ( ISC ~) 
I 1 

$~ECREATE (DIRECTORY NAME) PS : <REMARKS> C^T) 

[NEW] 

$$ 

^Step 97: Press the RETURN Key. 

Upon completion of the above step, the system prints [NEW] and $$. 
Press the RETURN key and proceed to the next step. 



3.6 CREATING THE LPFORM.INI FILE 

If the LPFORM.INI file is created, each time LPTSPL receives a request 
for the line printer, the system does the following: 

1. Prints the name of the user who requested the line printer. 
(BANNER) 

2. Prints the name of the file that is being printed. (HEADER) 

3. After all the information in that file is printed, it prints 
the user's name again. (TRAILER) 

If this file is omitted, each time a request for the line printer is 
received, LPTSPL will use the system default. 

^Step 98: Give the Command: CONNECT (TO DIRECTORY) PS:<SUBSYS> and 
Press the RETURN Key. 

The LPFORM.INI file must reside in the directory PS:<SUBSYS>. Type 
CONNECT and press the ESC key. The system prints (TO DIRECTORY). 
Type PS:<SUBSYS> and press the RETURN key. 



I 

$CONNECT (TO DIRECTORY) PS : <SUBSYS> ChD 

$ 
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^Step 99: Give the Command: CREATE (FILE) LPFORM.INI and Press the 
RETURN Key. 

Use your system's text editing program to create the LPFORM.INI file. 
(The example below uses the editing program, EDIT.) Type CREATE and 
press the ESC key. The system prints (FILE). Type LPFORM.INI and 
press the RETURN key. The system proceeds into edit mode and prints 
00100. The parameters in the example below are used only for 
explanatory purposes. You must decide the parameters to be used on 
your system. 



I 



$CREATE (FILE) LPFORM . INI ChLJ 

INPUT: LPFORM.INI.l 

00100 NORMAL/BANNER:2/HEADER:2/TRAILER:2CsD 

00200 NARROW/BANNER: 2/HEADER : 2/TRAILER : 2/WIDTH : 72 GJD 

00300 

The above example causes the user's name and the filename to be 
printed twice on both normal and narrow forms before the actual data 
is printed. Also, after all the data is printed, the system prints 
the user's name twice again on both normal and narrow forms. The 
parameter WIDTH:72 informs the system that a maximum of 72 characters 
can be printed horizontally on narrow forms. (Refer to the TOPS-20 
Operator's Guide for a complete description of all the LPFORM.INI 
parameters . ) 

^Step 100: Press the ESC Key. Type EU and Press the RETURN Key. 

To leave edit mode and save the file without line numbers, press the 
ESC key. The system prints the edit prompt. Type EU and press the 
RETURN key. The system prints the filename and the generation number, 
then the TOPS-20 command prompt. 



00300 
*EUChD 
[LPFORM.INI.l] 
$ 



NOTE 



If your system is going to be part of 

the ARPA network, you should perform the 

steps in Appendix C before going on to 
Chapter 4. 



NOTE 

Perform Step 101 through Step 111 only 
if you are using an RP07 disk drive for 
your system structure. 
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3.7 BUILDING A FRONT-END FILE STRUCTURE 

Steps 101 through 111 describe how to build an RP04 or RP06 structure 
for the front-end file system when you are using an RP07 disk pack for 
the TOPS-20 file system. 



^Step 101: Give the Command: 
RETURN Key. 



RUN 



(PROGRAM) CHECKD and Press the 



To run CHECKD to create a structure for your front-end file system, 
type RUN and press the ESC key. The system prints (PROGRAM) . Type 
CHECKD and press the RETURN key. The system prints the prompt 
CHECKD>. 

1 

$RUN (PROGRAM) CHECKD (jST) 
CHECKD> 



^Step 102: 



Give the CHECKD 
FE-SYS 



Command: CREATE (NEW FILE SYSTEM FOR) 



To inform the system that you are creating a structure, type CREATE 
and press the ESC key. The system prints (NEW FILE SYSTEM FOR). Type 
the name of the structure. The structure name can consist of 1 to 6 



alphanumeric characters. The example uses FE-SYS. 
key. The system prints ENTER ALIAS:. 



Press the RETURN 



CHECKD>CREATE (NEW FILE SYSTEM FOR) FE-SYS 
ENTER ALIAS: 



^Step 103: Give the Command: FE-SYS and Press the RETURN Key. 

To inform the system of the alias name of the structure, type FE-SYS 
and press the RETURN key. The system prints HOW MANY UNITS IN THIS 
STRUCTURE: 

ENTER ALIAS: FE-SYS CUD 

HOW MANY UNITS IN THIS STRUCTURE: 

^Step 104: Give the Command: 1 and Press the RETURN Key. 

The front-end file system can only reside on a single structure. Type 
1 and press the RETURN key. The system prints CHANNEL, CONTROLLER, 
AND UNIT NUMBER FOR LOGICAL UNIT 0:. 

HOW MANY UNITS IN THIS STRUCTURE: 1 C"Q 

CHANNEL, CONTROLLER, AND UNIT NUMBER FOR LOGICAL UNIT 0: 
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^Step 105: Give the Command: 1, -1, and Press the RETURN Key. 

The front-end file system must reside on either an RP04 or RP06 disk 
drive that is connected to both the KL10 and PDP11 front-end. If you 
are not sure, type a ? and press the PETUPN key. The system prints 
the information needed to make the decision. The example uses channel 
1 ,. controller -1 (which is the default), and unit 0. After you type 
this information, the system prints NUMBER OF PAGES TO ALLOCATE FOR 
SWAPPING? 

CHANNEL, CONTROLLER, AND UNIT NUMBERS FOR LOGICAL UNIT 0: 1, -1, C^T) 
NUMBER OF PAGES TO ALLOCATE FOR SWAPPING? 

^Sfcep 106: Type the Number of Pages to Allocate for Swapping and Press 
the RETURN Key. 

If you plan to use this structure as a secondary system structure, 
type a decimal number between 2000 and 40,000 and press the RETURN 
key. Otherwise, type and press the RETURN key. The example assumes 
you will be using this structure as a secondary structure. 

NUMBER OF PAGES TO ALLOCATE FOR SWAPPING? 7 035 GeD 
NUMBER OF PAGES TO ALLOCATE FOR THE FRONT-END FILE SYSTEM? 

^Step 107: Type the Number of Pages to Allocate for the Front-End File 
System and Press the RETURN Key. 

To allocate the number of pages to reserve for the front-end file 
system, type 950 and press the RETURN key. The system prints OWNER 
NAME? 

NUMBER OF PAGES TO ALLOCATE FOR THE FRONT-END FILE SYSTEM? 950 C^Q 
OWNER NAME? 

^Step 108: Type the Owner's Name and Press the RETURN Key. 

Type the owner's name of the structure and press the RETURN key. The 
owner's name can be from 1 to 12 alphanumeric characters. The example 
uses the name OPERATOR. The system prints IS THIS A SYSTEM STRUCTURE 
FOR STARTUP? 



OWNER NAME? OPERATOR (j*D 

IS THIS A SYSTEM STRUCTURE FOR STARTUP? 

^Step 109: Type YES And Press the RETURN Key. 

To inform the system that this structure will be used at system 
startup, type YES and press the RETURN key. The system prints SERIAL 
NUMBER OF CPU STARTED FROM THIS STRUCTURE? 

IS THIS A SYSTEM STRUCTURE FOR STARTUP? YES CSQ 
SERIAL NUMBER OF CPU STARTED FROM THIS STRUCTURE? 
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^Step 110: Type the Serial Number of the CPU and Press the RETURN Key. 

The system prints information pertaining to mounting and dismounting 
the structure and then the CHECKD prompt. 



SERIAL NUMBER OF CPU STARTED FROM THIS STRUCTURE? 2102 QeD 

[FE-SYS: MOUNTED AS FE-SYS : ] 

[DISMOUNTING STRUCTURE - FE-SYS:] 
CHECKD> 

^Step 111: Give the CHECKD Command: EXIT and Press the RETURN Key. 

To exit the CHECKD program, type EXIT and press the RETURN key. The 
system prints the TOPS-20 command prompt $. 

CHECKD>SXIT G'fD 
$ 

NOTE 

When performing the steps in Chapter 4, 
be sure you install the front-end file 
system on the structure you have just 
created. 
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The steps in this chapter restore the front-end file system when you 
reinitialize it or change the front-end hardware. They also restore 
the front-end software if the front-end file system on disk is 
destroyed. 

These steps copy the front-end software from the floppy disks to the 
front-end file space on the public structure. They involve the 
following front-end programs: 

MOU Adds a device to the list of front-end devices. 

UFD Creates a directory in the front-end file space on the 
public structure. 

PIP Copies files from the floppy disk to the public structure. 

RED Changes the definition of the front-end logical name SYO : 
from the floppy disk to the public structure. 

SAV Saves the front-end monitor. 

INI Initializes the front-end file system on the public 
structure . 



4.1 HALTING THE TOPS-20 MONITOR 

W^ Step 112: Make Sure that the Correct Floppy Disks Are Mounted. 

Be sure that System Floppy A is mounted in the left drive (drive 0) 
and that System Floppy B is mounted in the right drive (drive 1) . 
(Refer to Step 7 in Chapter 2 if you have trouble.) 

W^ Step 113: Type CTRL/\. 

At the console terminal, type (ctrla ) to return to the front-end 
Command Parser. When you are at Command Parser command level, the 
system prints the prompt PAR> : 

fCTRLh ) 

PAR> 
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^Step 114: Type SHUTDOWN and Press the RETURN Key. 

To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key. 
The system prints a list of messages. 

PAR> SHUTDOWN© 
**HALTED** 

%DECSYSTEM-20 NOT RUNNING 

Error: If you mistype SHUTDOWN an error message is printed, after 
which you can reissue the command. 

The system must print %DECSYSTEM-20 NOT RUNNING. If it does 
not, type proTZ) and give the ABORT command. Go back to 
Step 113. 



4.2 RESTARTING THE FRONT-END MONITOR 

This entire procedure is invalid if you did not stop the TOPS-20 
monitor as described in Section 4.1. 

W^ Step 115: Set the Switch Register to 000003 (Octal). 

Set the front-end switch register to 000003 (switches 1 and up, the 
rest down) . 

^ Step 116: Hold ENABLE and Press the SWITCH REGISTER Button. 

Hold ENABLE and press the SWITCH REGISTER button to start the 
front-end monitor from drive 0. The system will print a few lines of 
information. After the system prints [DX1: MOUNTED] proceed to 
Section 4.3. 

RSX-20F VB14-44 6:11 5-MAR-82 

[SY0: REDIRECTED TO DX0 : ] 
[DX0: MOUNTED] 
[DX1: MOUNTED] 

Error: If you left the switch register set to 000007, the system 
starts the KL Initialization routine. In this case, the 
printout looks like this: 

RSX-20F VB14-44 6:11 5-MAR-82 

[SY0: REDIRECTED TO DX0 : ] 

[DX0: MOUNTED] 

[DX1: MOUNTED] 

KLI — VERSION VB12-27 RUNNING 
KLI — ENTER DIALOG [ NO , YES , EXIT , BOOT] ? 
KLI> 

Set the switch register to 000003 and press the ENABLE and 
SWITCH REGISTER buttons again. 
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If you set the switch register to 000003, the system may 
print: 

11-HALT 
TO 4 

or 

**This VOLUME DOES NOT CONTAIN A HARDWARE-BOOTABLE SYSTEM** 

Set the switch register correctly and press the ENABLE and 
SWITCH REGISTER buttons again. 



4.3 COPYING FILES FROM FLOPPY DISK TO RP04 OR RP06 

Use the following procedures to copy the files. Remember that you are 
typing commands to the front end and that you must wait for a prompt 
before typing the answer. There is no type-ahead feature except when 
you want to type a ictrIT ■ '). You can type a ictrD u ) to erase an entire 
line or press the DELETE key to erase a single character per 
keystroke. 

Many of the steps in this chapter and in Chapter 5 assume that the 
disk pack is mounted on drive 0. To use a dual-port drive other than 
drive 0, make the following changes: 

1. Where a step calls for DB0 : to be typed, type the number of 
the actual drive used. For example: DB1 : , DB2:, etc. 
Messages printed by the system will reflect this change. 

2. If the disk is mounted on a drive other than drive 0, 
pressing ENABLE and DISK in Step 151 will not work. Instead, 
set the front-end switch register switches 7 and in the up 
position. Set switches 10, 9, and 8 to the binary number of 
the drive used. For example, for drive 1, set switch 8 up; 
for drive 2, set switch 9 up; for drive 3, set switches 9 
and 8 up. After this has been completed, press the ENABLE 
and SWITCH REGISTER buttons. 

W^ Step 117: Type CTRL/\. 

To start the front-end Command Parser, type ictrl7T~ ! . The system takes 
about 10 seconds to load the Command Parser from the floppy disks. 
You are at Command Parser command level when the system prints the 
prompt PAR%. The % after PAR indicates that the central processor is 
not running: 

[DX1: MOUNTED] 

(CTRL/'. ) 



PAR% 



W^ Step 118: STOP. 

The central processor (as opposed to the front-end processor) must be 
halted before you proceed to the next step. If the central processor 
is not halted, the front-end monitor will not be saved in the 
front-end file system in a usable state. When the central processor 
is stopped, the system prints a percent sign, %, following the Command 
Parser prompt. If it prints an angle bracket, >, give the SHUTDOWN 
command and type (ctrla ] before continuing. 
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^Step 119: Type MCR INI and Press the RETURN Key. 

To start the INITIALIZE program, type MCR INI and press the RETURN 
key. When the INITIALIZE program is ready for you to type commands 
(after a few seconds), it prints the prompt INI> : 

PAR%MCR INI® 

INI> 

^Step 120: Type DBO : , and Press the RETURN Key. Wait 5 Seconds and 
Perform the Next Step. 

To initialize the front-end file system on the public structure, type 
DBO: and press the RETURN key. In about 5 seconds, the INI program 
finishes. It does not reprint the prompt. Proceed directly to the 

next step. 

INI>DB0:(H) 

Error: If you type the wrong device name or get an error message, 
start again at Step 117. If you still get an error message, 
press the front-end HALT switch and wait one minute. Go 
back to Step 116. 

^Step 121: Type CTRL/V 

To start the front-end Command Parser, type BED. When the Command 
Parser is ready for you to type commands (about 10 seconds) , it prints 
the prompt PAR% : 

fCTRU- ) 
PAR% 

NOTE 
Nothing happens until you type i ctrla ) . 

W^ Step 122: Type MCR MOU and Press the RETURN Key. 

To start the MOUNT program again, type MCR MOU and press the RETURN 
key. When you are at MOUNT command level, the system prints MOU> : 

PAR%MCR MOU© 
MOU> 

Error: If you make a typing error, reissue the command. 

^Step 123: Type DBO: and Press the RETURN Key. 

To allow the front end to use its reserved area on the dual-port disk 
(the one with the channel selector set to A/B) , type DBO: and press 
the RETURN key. When the mount operation is complete, the system 
prints a message and the prompt, MOU> : 

MOU>DB0 :(H! 

MOU — MOUNT COMPLETE 

MOU> 
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Error: If you mistype DBO : , the mount operation may fail. If this 
happens and the system reprints the prompt MOU> , reissue the 
command. Otherwise, go back to Step 121. 

^Step 124: Type CTRL/Z and CTRL/\. 

To terminate the MOUNT program and start the front-end Command Parser, 
type Lctrl/zJ , followed by prajri . After about 10 seconds, when the 
system is at Command Parser command level, it prints the prompt PAR% : 



( CTRl/Z , 
i 

MOU>~Z 



I CTRLr 



PAR% 



^ Step 125: Type MCR UFD and Press the RETURN Key. 

To run the UFD program, type MCR UFD and press the RETURN key. The 
system loads the program from the floppy disk and starts it. After a 
few seconds, UFD is ready for you to type commands and prints the 
prompt UFD>: 

PAR%MCR UFD (13 

UFD> 

Error: If you make a typing error, reissue the command. 

W^ Step 126: Type DBO: [5,5], Press RETURN Key, Wait 10 Seconds and 
Perform the Next Step. 

To create the directory (in the front-end reserved space on the public 
structure) that contains the front-end file system, type DBO: [5,5] and 
press the RETURN key. When the UFD program finishes, it does not 
reprint the prompt. Wait 10 seconds and then proceed directly to the 
next step: 

UFD>DB0: [5,5] m 

Error: If the system prints: 

UFD — FAILED TO CREATE DIRECTORY 

you probably did not give the correct command the last time 
you ran the MOU program. Go back to Step 118. 

Error: If the system prints: 

UFD — DIRECTORY ALREADY EXISTS 

you should delete all files in the directory before going 
on. Perform the steps below: 

UFD — DIRECTORY ALREADY EXISTS 

( CTRlP H 

PAR%MCR PIP <m 

PIP>DB0 :*. */DE(H) 

Now skip to Step 129. 
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^Step 127: Type CTRL/V 

To load the front-end Command Parser from the floppy disk, type 
fCTRLjn After 10 seconds, the Command Parser is at command level and 
the system prints the prompt PAR% : 



(CTRL.- 



PAR% 

NOTE 
Nothing happens until you type (ctrl; J . 

W^ Step 128: Type MCR PIP and Press the RETURN Key. 

To load the PIP program from the floppy disk and start it, type MCR 
PIP and press the RETURN key. After 10 seconds, PIP is ready for you 
to type commands. The system prints the prompt PIP> : 

PAR%MCR PIP© 
PIP> 
Error: If you make a typing error, reissue the command. 

W^ Step 129: Type DBO :/NV=DX0 :*.*,DX1 : * . * and Press the RETURN Key. 

To copy the newest version of all the files from the floppy disks 
(Doth drive and drive 1) to the front-end file system on the public 

structure, type DBO :/NV=DX0 : * . * ,DX1 :* . * and press the RETURN key. 
(You can use (ctrlTlQ and the DELETE key to help type this line and 

others in this chapter.) You will hear clicking as the system accesses 

the floppy disks. After about 10 minutes , the transfer is complete 

and the system prints the prompt PIP> : 

PIP>DB0:/NV=DX0:*.*,DX1 : * . * (ret) 
PIP> 

Error: If you make a typing error, reissue the command. 



W^ Step 130: Type CTRL/Z and CTRL/V 



To end PIP and start the front-end Command Parser, type (ctrl/T] 
followed by [ 5trl~1 . After 10 seconds, the system is ready to accept 
commands and prints the prompt PAR% : 

gfRLTzj 
i 
PIP>~Z 

(CTRL/ ! 



PAR% 
Error: If you make a typing error, reissue the command. 
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^ Step 131: Type MCR RED and Press the RETURN Key. 



To load and start the REDIRECT program from floppy disk, type MCR RED 

and press the RETURN key. After the REDIRECT program is ready to 

accept commands (about five seconds), the system prints the REDIRECT 
prompt RED> : 

PAR%MCR RED (RET) 
RED> 



Error : 



If you make a typing error, reissue the command, 



W^ Step 132: 



Type DB0:=SY0: and Press the RETURN Key. 
and Perform the Next Step. 



Wait 



Seconds 



To redirect the primary front-end file structure from the floppy disks 
to the front-end file system on the public structure, type DB0:=SY0: 



and press the RETURN key. 
finished and does not 
next step. 

RED>DB0:=SY0:dT) 



After 5 seconds, the REDIRECT program is 
reprint the prompt. Proceed directly to the 



Error: If this operation fails or if you make a mistake and the 
system has printed the prompt RED>, reissue the command. If 
it still fails, perform Steps 115 through 117 and Steps 122 
through 124, then continue at Step 131. (Even this may not 
work. You may have to perform all the steps again, 
beginning with Step 115.) 



^ Step 133: Type CTRL/\. 



To start the front-end Command Parser, type icjrlt J . After one second, 
the system loads and starts the Command Parser and prints the prompt 
PAR%: 

fCfRL/T) 



PAR% 



W^ Step 134: Type MCR SAV and Press the RETURN Key. 

To start the SAVE program, type MCR SAV and press the RETURN key. 
After one second, the SAVE program is ready to accept commands and the 
system prints the prompt SAV> : 

PAR%MCR SAV® 
SAV> 



Error : 



If you make a typing error, reissue the command. 



^ Step 135: Set the Switch Register to Zero. 

Before proceeding, set the switch register to zero (all switches 
down) . 



4-7 



CREATING THE FRONT-END FILE SYSTEM 

^ Step 136: Type SY0:/WB and Press the RETURN Key. 

To save the system bootstrap and the front-end monitor in the 
front-end file system on the public structure, type SY0:/WB and press 
the RETURN key (WB stands for write bootstrap) . After the bootstrap 
and the monitor are saved, the system prints a message and the front 
end restarts itself at the save entry point: 

SAV>SY0:/WB(RE? 
[DBO: DISMOUNTED] 
[DXO: DISMOUNTED] 
[DXl: DISMOUNTED] 

RSX-20F VB14-44 6:28 5-MAR-82 

[SYO: REDIRECTED TO DBO:] 
[DBO: MOUNTED] 

The last two messages inform you that the front end is using the 
files on the TOPS-20 file system instead of on the floppy disks. 

Error: If you make a typing error, reissue the command. 



t^ Step 137: Store the Floppy Disks A and B. 

Remove the floppy disks, insert their in their covers, and store them 
in a safe place. 

NOTE 

If you have some spare floppies 
available, it is a good idea to copy 
System Floppies A and B to the spare 
floppies for backup purposes. Refer to 
the TOPS-20 System Manager's Guid e for 
this procedure. 

^ Step 138: Mount System Floppy C on Drive 

Mount System Floppy C in the left drive (drive 0). (Refer to Step 7 
in Chapter 2 if you have trouble.) 

t^ Step 139: Type CTRL/\ 

To start the front-end Command Parser again, type ( ctrl: ) . After one 
second, the system loads and starts the Command Parser and prints the 
prompt PAR% : 

CTRL j 

PAR% 
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W^ Step 140: Type MCR MOU and Press the RETURN Key. 

To start the MOUNT program, type MCR MOU and press the RETURN key. 
When the system is at MOUNT command level, the system prints the 
prompt MOU> : 

PAR%MCR MOU© 
MOU> 

Error: If you make a typing error, reissue the command. 

W^ Step 141: Type DXO : and Press the RETURN Key. 

The MOUNT program mounts floppy drive 0, then prints the message MOUNT 
COMPLETE: 

MOU > DXO:© 

MOU — MOUNT COMPLETE 

t^ Step 142: Type CTRL/Z and CTRL/\. 

To terminate the MOUNT program and start the front-end Command Parser, 
type i cTRL/F ) , followed by (EtrlTT") . After about one second, when the 
system is at Command Parser command level, it prints the prompt PAR% : 

EmjT) 

MOU>"Z 

PAR% 

W^ Step 143: Type MCR PIP and Press the RETURN Key. 

To run the PIP program, type MCR PIP and press the RETURN key. When 
PIP is at command level, it prints the prompt PIP> : 

PAR%MCR PIP© 
PIP> 

Error: If you make a typing error, retype the command. 

^ Step 144: Type DB0:/NV=DX0:*.* and Press the RETURN Key. 

Copy the contents of System Floppy C to the disk by typing 
DB0:/NV=DX0:*.*. This copies RSX20F.MAP to the disk. When the file 
is copied, PIP prints the prompt PIP>: 

PIP>DB0 :/NV=DX0 : * . * © 
PIP> 

W^ Step 145: Type DB0:/LI and Press the RETURN Key. 

To get a list of the files on the front-end file system, type DB0:/LI 
and press the RETURN key. The system prints the list of the files 
copied from floppies A, B, and C. Check it against the directory 
listing shown in the TOPS-20.BWR file to be sure that you have all the 
files shown there. The TOPS-20.BWR file is located on the TOPS-20 
Installation tape. 
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The directory listing shown here is only a sample. Do not worry about 
the order of the files, generation numbers, or dates and times when 
comparing the files. The file sizes (indicated in the second column 
in 256-word blocks) should be the same. When the listing is finished, 
the system prints the prompt PIP> : 

PIP>DB():/LIiREj) 

DIRECTORY DBO : [5,5] 
5-OCT-81 16:36 



F11ACP.TSK;1 


77. 


C 


24-NOV-80 


16: 


:30 


KLDISC.TSK;1 


5. 


C 


24-NOV-80 


16: 


:30 


KLRING.TSK;1 


6. 


C 


24-NOV-80 


15: 


:30 


KLXFER.TSK;1 


5 


C 


24-NOV-80 


16: 


:30 


MIDNIT.TSK;! 


4. 


C 


24-NOV-80 


16: 


: 31 


SETSPD.TSK;1 


4. 


C 


24-NOV-80 


16: 


:31 


TKTN.TSK;1 


6. 


C 


24-NOV-80 


16: 


:31 


KLE.TSK;1 


28. 


C 


24-NOV-80 


16: 


:31 


KLI.TSK;1 


66. 


c 


24-NOV-80 


16: 


:31 


MOU.TSK;l 


5. 


C 


24-NOV-80 


16: 


;32 


KLA.MCB;231 


36. 




24-NOV-80 


16: 


:32 


KLX.MCB;231 


42. 




24-NOV-80 


16: 


:32 


BOOT.EXB;l 


60. 




24-NOV-80 


16: 


:32 


MTBOOT.EXB;l 


60. 




24-NOV-80 


16: 


:33 


BF16N1.A11;1 


1. 




24-NOV-80 


16: 


:33 


KL.CFG;1 


1. 




24-NOV-80 


16: 


:33 


PARSER. TSK;1 


48. 


c 


24-NOV-80 


16: 


:33 


T20ACP.TSK;1 


8. 


C 


24-NOV-80 


16: 


:34 


BOO.TSK;l 


19. 


C 


2 4- NOV- 80 


16: 


:34 


COP.TSK;l 


8. 


C 


24-NOV-80 


16: 


:34 


DMO.TSK;l 


5. 


C 


24-NOV-80 


16: 


:34 


INI.TSK;1 


23. 


C 


24-NOV-80 


16: 


:34 


PIP.TSK;1 


56. 


C 


24-NOV-80 


16: 


:35 


RED.TSK;1 


6. 


C 


24-NOV-80 


16: 


:35 


SAV.TSK;1 


13. 


C 


24-NOV-80 


16: 


:35 


UFD.TSK;1 


9. 


C 


24-NOV-80 


16. 


:35 


ZAP.TSK;1 


38. 


C 


24-NOV-80 


16: 


:35 


RSX20F.SYS;1 


57. 


C 


24-NOV-80 


16: 


:36 


RSX20F.MAP;! 


142 


. 


24-NOV-80 16:36 



TOTAL OF 858. BLOCKS IN 28. FILES 
PIP> 

W^ Step 146: Type CTRL/Z and CTRL/\ 

To exit from the PIP program, type a ictrlTzj . To restart the front-end 
command parser, type a ctrl """ i . When at command level, the front-end 
command parser prints the prompt PAR% : 

:':RL Z i 

PIP>~Z 

"RL ' 

PAR% 
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^ Step 147: Type MCR DMO and Press the RETURN Key. 

To start the DMO program, type MCR DMO and press the RETURN key. When 
at command level, the DMO program prints the prompt DMO: 

P MCR DMO© 
DMO> 

^ Step 148: Type DXO : and Press the RETURN Key. 

To dismount the floppy drive, type DXO: and press the RETURN key. 
After a few seconds, when the drive is dismounted, DMO prints a 
message and the prompt DMO: 

DMO>DXC:@ 

DMO — DISMOUNT COMPLETE 

DMO> 

t^ Step 149: Type a CTRL/Z and CTRL/\ 

To exit from the DMO program, type a ( ctrlTzI followed by a icihl >. 
When you return to command level, the front-end command parser prints 
the prompt PAR% : 

(CTRL/YJ 
I 

DMO~Z 
PAR% 

NOTE 

If you have a spare floppy available, it 
is a good idea to copy System Floppy C 
to the spare floppy for backup purposes. 
Refer to the TOPS-20 System Manager's 
Guide for this procedure . 
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chapter 5 
restarting the system 

At this point you have: 

1. Initialized the TOPS-20 file system. 

2. Loaded the TOPS-20 monitor and related programs into 
directories PS:<SYSTEM> and PS:<SUBSYS>. 

3. Loaded the files for the TOPS-20 User Environmental Test 
Package into directory PS: <UETP.LIB> . 

4. Created the system initialization files. 

5. Loaded the front-end software into the TOPS-20 file system. 

Now the TOPS-20 file system is intact, and the standard TOPS-20 
bundled software is completely installed on your system. This means 
you can stop the system and reboot it from the file system on disk. 

Whenever you have to restart the system, be sure that the central 
processor is stopped; otherwise you can damage the file system you 
just created. 

^ Step 150: Be Sure that the Central Processor Is Stopped 

Check your output to be sure that the last time the system printed the 
prompt PAR (in Step 149) it was followed by a % to indicate that the 
central processor has stopped. If the prompt is followed by a > , type 
SHUTDOWN and press the RETURN key. 

^Step 151: Hold ENABLE and Press the DISK Button. 

To restart the system, hold ENABLE and press the DISK button. The 
system restarts after a few seconds and obtains all the software from 
the TOPS-20 file system. 

If the TOPS-20 file system is on a drive other than drive 0, holding 
the ENABLE button and pressing the DISK button does not work. You 
must set the switch register to the appropriate disk drive. For 
example, if the TOPS-20 file system is on drive 1, set switches 8, 7, 
and up; for drive 2, set switches 9, 7 and up. (Refer to Part 4, 
Chapter 1, of the TOPS-20 Operator's Guide for more information on 
setting the switch register.) 
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Once you have set the switches to the appropriate disk drive, hold 
ENABLE and press the SWITCH REGISTER button rather than the DISK 
button. When you follow this procedure, the system prints the 
question, KLI — ENTER DIALOG [ NO , YES , EXIT , BOOT] ? and waits for a 
reply. Reply by pressing the RETURN key. 

RSX-20F VB14-45 6:11 5-MAR-82 

[SYO: REDIRECTED TO DBO : ] 

[DBO: MOUNTED] 

KLI — VERSION YB12-27 RUNNING 

KLI — KL10 S/N: 2102., MODEL B, 60 HERTZ 

KLI — KL10 HARDWARE ENVIRONMENT: 

MOS MASTER OSCILLATOR 

EXTENDED ADDRESSING 

INTERNAL CHANNELS 

CACHE 

KLI — MICROCODE VERSION 273 LOADED 
KLI — ALL CACHES ENABLED 

LOGICAL MEMORY CONFIGURATION 
ADDRESS SIZE INT TYPE CONTROLLER 
00000000 1024K 4 MF20 4 

KLI — CONFIGURATION FILE WRITTEN 
KLI — BOOTSTRAP LOADED AND STARTED 

BOOT V10. 0(151) 

[BOOT: LOADING RESIDENT MONITOR] [OK] 

[PS MOUNTED] 

[BOOT: LOADING SWAPPABLE MONITOR, PASS1] [OK] 

System restarting, wait... 
ENTER CURRENT DATE AND TIME: 

The line "System restarting, wait..." is printed on all the terminals 
currently connected to the system to inform users that the system will 
soon be ready to use. 

Error: If the system prints: 

*** THIS VOLUME DOES NOT CONTAIN A HARDWARE BOOTABLE SYSTEM *** 

the disk pack on the dual-port drive does not contain the 
front-end software. Pernaps the wrong disk pack has been 
mounted. But if everything appears to be in order, try the 
steps in Chapters 2 through 4 again. If the error 
continues, contact DIGITAL Software Support. 

If the system does nothing when you press the switches, you 
may have pressed ENABLE and SWITCH REGISTER by mistake. Try 
pressing ENABLE and DISK. 

If the system prints JSYS error messages between the lines 
[PS MOUNTED] and System restarting, wait..., you probably 
have mistyped some information in the 
PS:<SYSTEM>5-CONFIG.CMD file. Use EDIT to check the file 
and correct any errors. 
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^ Step 152: Type the Date and Time and Press the RETURN Key. 
After the prompt, type the date and time in the form: 

day-month-year hhmm 
Then press the RETURN key: 

ENTER CURRENT DATE AND TIME: 5-MAR-82 1112© 

YOU HAVE ENTERED WEDNESDAY, 5-MAR-8 2 11:12AM, 
IS THIS CORRECT (Y,N) 

^Step 153: Type Y or N and Press the RETURN Key. 

After the system prints the date and time, check to be sure that it is 
correct. If it is, type Y and press the RETURN key. If the date or 
time is incorrect, type N, press the RETURN key, and go back to the 
Step 152: 

YOU HAVE ENTERED WEDNESDAY, 5-MAR-82 11:12AM, 

IS THIS CORRECT (Y,N) Y© 
WHY RELOAD? 

^ Step 154: Type SC and Press the RETURN Key. 

If you plan to install optional software, type SC and press the RETURN 
key. When you bring up the system for any other reason, type one of 
the abbreviations listed in Table 5-1, below: 



WHY RELOAD? SC(® 

<SYSTEM> ACCOUNTS-TABLE. BIN NOT FOUND 

RUN CHECKD? 



ACCOUNT VALIDATION IS DISABLED 



Table 5-1 
System Reload Abbreviations 



Abbreviation 


Meaning 


OP 


OPR 


PA 


Parity 


PO 


Power 


ST 


Static 


HAR 


Hardware 


HA 


Halt 


HU 


Hung 


PM 


Preventive Maintenance 


CM 


Corrective Maintenance 


SA 


Stand-alone 


NE 


New 


SC 


Scheduled 


OT 


Other 
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W^ Step 155: Type N and Press the RETURN Key. 



The CHECKD program examines the entire disk file system, reports any 
errors, and tries to correct them. You do not have to run this 
program unless the system crashes unexpectedly, or if, for some other 
reason, you suspect that there may be disk errors. If you halt the 
system by giving a CTRL/E CEASE command or by using some other 
controlled means, you do not have to run CHECKD before restarting. 



Type N and press the RETURN key. 
runs the SYSJOB.RUN file. 



The system prints RUNNING DDMP and 



If you do run CHECKD, it takes about four minutes per disk drive. Be 
prepared for a long wait until the system prints something on your 
console terminal. For each inconsistency, CHECKD prints a message and 
the directory in which the error occurred. (Refer to the TOPS-20 
Operator's Guide for a list of CHECKD error messages.) 

RUN CHECKD? N(RETj 

RUNNING DDMP 



SYSJOB 5(14) STARTED AT 5-MAR-82 1112 
RUN SYS:ORION 
RUN SYS: QUASAR 



TGHA V2(6) IS RUNNING FOR THE FIRST TIME. 



5-MAR-82 11:12:09 
***** 

RUN SYS:MOUNTR 

RUN SYS: INFO 

RUN SYS: MAILER 

RUN SYS: MAPPER 

RUN SYS:LPTSPL 

RUN SYS:CDRIVE 

RUN SYS: SPRINT 

JOB /LOG OPERATOR XX OPERATOR 

ENA 

"ESET LOGIN PSEUDO 

"ESET LOGIN CONSOLE 

"ESET OPERATOR 

PTYCON 

GET SYSTEM: PTYCON. ATO 

/ 

JOB 1 /LOG OPERATOR XX OPERATOR 

ENA 

RUN SYS:BATCON 



10/5-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 5(3117) 
10/5-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 5(3117) 



/ 




SJ 





SJ 





SJ 


1 


SJ 


1 
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@LOG OPERATOR OPERATOR 
@LOG OPERATOR OPERATOR 

JOB 1 ON TTY206 5-OCT-81 11:12:22 
@ENA 

$"ESET LOGIN PSEUDO 
$"ESET LOGIN CONSOLE 
$~ESET OPERATOR 
$PTYCON 

JOB 2 ON TTY207 5-OCT-81 11:12:23 
@ENA 

PTYCON> GET SYSTEM: PTYCON .ATO 
PTYCON> SILENCE 
$RUN SYS:BATCON 

[From OPERATOR on line 210: SYSTEM IN OPERATION] 
PTYCON. LOG. 1 
PTYCON> W ALL 

OPR(0) 3 OPERATOR OPR TI 0:0:1 

PTYCON> CONN OPR 
[CONNECTED TO SUBJOB OPR(0)] 



SJ 





SJ 


1 


SJ 





SJ 





SJ 





SJ 





SJ 





SJ 





SJ 


1 


SJ 


1 


SJ 





SJ 





SJ 


1 


[From 


SJ 





SJ 





SJ 





SJ 





SJ 
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CHAPTER 6 
INSTALLING OPTIONAL SOFTWARE 



DIGITAL sells a number of optional software products in addition to 
the TOPS-20 bundled software package. The TOPS-20 bundled software is 
delivered with the system; but, if you need any optional software, it 
must be purchased separately. The current optional software products 
are listed in Table 6-1. 



Table 6-1 
Optional Software Products 



Product 



FORTRAN- 20 

ALGOL- 20 

SORT- 20 

DBMS- 20 

CPL-20 

COBOL-68 with SORT-20 

APL-20/SF 

APL-20 BASIC 

IQL-20 EXTENDED 

BASIC-PLUS-2 

COBOL-74/68 with SORT-20 

BLISS-36 



Product Code 



_L 



QT001-AM 
QT002-AM 
QT007-AM 
QT008-AM 
QT009-AM 
QT011-AM 
QT012-AM 
QT014-AM 
QT016-AM 
QT027-AM 
QT099-AM 
QT115-AM 



The steps in this chapter describe how to install any of the above 
optional software products, the contents of the TOPS-20 Distribution 
tape, and the contents of any TOPS-20 update tape. 

If you are installing the TOPS-20 DECnet-20 software on a 
DECSYSTEM-2040S or 2060, follow the steps in the TOPS-20 DECnet-20 
Manual . 

If you are installing the IBM communications software, follow the 
steps in the IBM Emulation/Termination Manual. 

These software tapes have at least two savesets: 

1. DOCUMENTS, which contains five types of files that will be 
restored to PS: <OPERATOR> or to the directory of your choice: 



product. MEM 
product .SD 



Describes the format of the tape and how to 
install and build the particular product. 

Lists all the source files that you need to 
build the product from scratch. 
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product. BD Lists all the binary files that you must 
load from the tape into the directory 
PS:<SUBSYS> to use the product. 

product. BWR Contains a list of known errors and 
warnings about the product (if any) . 

component.DOC Gives useful information about each 
component of the product. 

2. SUBSYS, which contains all the files (.EXE, .HLP, .REL, etc.) 
that you must load into PS:<SUBSYS> to use the product. 

An additional saveset, SOURCES, is present on some software 
tapes. If this saveset exists, it contains all the sources 
you need to build the product from scratch, plus a .LOG file 
generated when the files in the second saveset were created. 
The FORTRAN tape contains three source savesets: one for 
FORTRA and BLIS10, one for FOROTS and FORLIB, and one for 
FORDDT. 

The steps in this section do not show how to install the source files. 
You can restore them to the directory of your choice. These files are 
not required to run the product. Leaving them on the tape is 
acceptable . 

You can use the line printer to list the files in the DOCUMENTS save 
set, or you can load them into a special directory. You must load the 
files in the second saveset into PS:<SUBSYS> to be able to run the 
product. You do not have to store the source files on disk unless you 
are building the product from scratch (which is not required, because 
all the necessary files are stored in the second saveset) . 

You may wish to dedicate a separate disk pack to store the contents of 
your tapes. If so, perform the installation procedure for that pack 
and restore all the files from the software tapes to that pack. With 
a separate disk pack containing the software, you can perform any 
special building that you need without using public disk space. 

The following steps show how to install the documents and system 
binary files. Repeat Steps 168 through 175 to install additional 
software products or to update existing software. 

NOTE 

The remaining steps in this manual 
assume that you are using the operator's 
console terminal (CTY) , as in previous 
steps. Although it is possible to 
perform the remaining steps at another 
terminal, you must then return to the 
CTY after completing the steps in this 
chapter to resume control of the system. 
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^Step 156: Type CTRL/C. 

Type CTRL/C to start a job at your terminal: 

(CfRJJcQ 

Installation-test System, TOPS-20 Monitor 5(3117) 

@ 

^Step 157: Type SYSTAT OPERATOR and Press the RETURN Key. 

To look at the operator jobs on the system, type SYSTAT OPERATOR and 
press the RETURN key. The system prints a list of the current 
operator jobs. Determine which operator job is running PTYCON . Use 
that job number in the next step. 

@SYSTAT OPERATOR® 






DET 


SYSJOB 


OPERATOR 


1 


206 


PTYCON 


OPERATOR 


2 


207 


BATCON 


OPERATOR 


3 


210 


OPR 


OPERATOR 



^Step 158: Give the Command: ATTACH (USER) OPERATOR (JOB#) n. 

Attach to the operator's job running PTYCON. Type ATTACH and press 
the ESC key. The system prints (USER) . Type OPERATOR and press the 
ESC key. The system prints (JOB #). Type the number of the job 
running PTYCON and press the RETURN key. The system prints a message 
similar to [PSEUDO-TERMINAL, CONFIRM] . Press the RETURN key. 

(H) (ES5) 

I i 

0ATTACH (USER) OPERATOR (JOB #) 1® 

[PSEUDO-TERMINAL, CONFIRM] (ret) 
PASSWORD: 

t^ Step 159: Type Your Password and Press the RETURN Key Twice. 

Type the operator's password and press the RETURN Key twice. The 
system prints the prompt for the OPR program. 

PASSWORD: your password ® 

® 

OPR> 
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^ Step 160: Give the Command: SHOW STATUS TAPE-DRIVE /ALL, and Press 
the RETURN Key. 

To find a tape drive that you can use for mounting the software tape, 
qive the OPR program command SHOW STATUS TAPE-DRIVE /ALL, and press 
the RETURN key. The system responds with a list of tape drives and 
their status. 

OPR>SHOW STATUS TAPE-DRIVE /ALL (RET) 

OPR> 
9:35:49 — Tape Drive Status-- 

DRIVE STATE VOLID REQ# JOB* USER 

MTAO : Unloaded 

AVR: Yes 
MTA1: In Use DEK 31 45 LARRUP 

AVR: Yes, Write: Yes, Unlabeled 
MTA2 : Loaded 

AVR: Yes, Write: Yes, Unlabeled 
MTA3 : Unloaded 

AVR: Yes 
MTA4 : Unloaded 

AVR: No 
MTA5: Unloaded 

AVR: Yes 
OPR> 

+ Step 161: Give the Command: SET TAPE-DRIVE MTAn: UNAVAILABLE. 

To mount the software tape, you should first make a free drive 

unavailable to timesharing users. The OPR program command SET 

TAPE-DRIVE MTAn: UNAVAILABLE accomplishes this. The example uses 

drive number 0, but you can specify any drive that is not in use at 
the moment. 

OPR>SET TAPE-DRIVE MTAO: UNAVAILABLE® 
Enter text and terminate with "Z 

W^ Step 162: Enter INSTALLING OPTIONAL SOFTWARE and Type CTRL/Z. 

Enter text and terminate with "z 

+ 

INSTALLING OPTIONAL SOFTWARE "Z 
OPR> 
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t} Step 163: Give the PUSH Command and Press the RETURN Key. 

To restore the contents of the tape, you should be at TOPS-20 command 
level. Giving the PUSH command to the OPR program puts you at TOPS-20 
command level. 

OPR> PUSH (RET) 
TOPS-20 Command processor 5(514) 



NOTE 

If you are using the console terminal, 
as recommended above, your PUSH command 
to OPR puts you at TOPS-20 command 
level. You then see the TOPS-20 prompt 
(@l . 

W^ Step 164: Give the Command: ASSIGN (DEVICE) MTAn:. 

Give the ASSIGN command to assign a magnetic tape drive to your job. 
The example uses drive number 0, but you can use any free drive of 
your choice. Type ASSIGN and press the ESC key. The system prints 
(DEVICE). Type MTAO : and press the RETURN key. The system prints 
the system prompt when the drive is assigned: 

(ESQ) 
i 
@ASSIGN (DEVICE) MTAO : (RE?) 
@ 

Error: If the device is assigned to another job, the system prints 
the message: 

7ALREADY ASSIGNED TO JOB n 

Use the command INFORMATION (ABOUT) AVAILABLE DEVICES to 
find an available tape drive. Reissue the ASSIGN command. 

^ Step 165: Give the Command: ENABLE (CAPABILITIES). 

Because you will be restoring files to restricted areas, you must 

enable your capabilities. Type ENABLE and press the ESC key. The 

system prints (CAPABILITIES) . Press the RETURN key. The system 
prints a $ prompt:: 

J, 

@ENABLE (CAPABILITIES) >1S1 
$ 



6-5 



INSTALLING OPTIONAL SOFTWARE 

^Step 166: Type DUMPER and Press the RETURN Key. 

To start DUMPER, type DUMPER and press the RETURN key. The system 
prints the DUMPER prompt: 

$DUMPER!H) 
DUMPER> 

DUMPER ERRORS 

If you get errors when using DUMPER, 
refer to the description of DUMPER in 
the TOPS-20 User Utilities Guide . 

^Step 167: Give the Command: TAPE (DEVICE) MTAn:. 

Tell DUMPER which tape drive to use. The example uses MTAO : ; but, if 

you have assigned another drive in Step 164, use that drive number. 

Type TAPE and press the ESC key. The system prints (DEVICE) . Type 

MTAO: and press the RETURN key. The system prints the DUMPER prompt: 

!ESCI 
~l 

DUMPER>TAPE (DEVICE) MTAO : (H) 
DUMPER> 

^ Step 168: Mount the Optional Tape or the Update Tape. 

Mount the optional tape or the update tape on the drive that is 
assigned to your job. Remember to press tne ON LINE button after 
mounting the tape on a TU45 tape drive. 

^ Step 169: Type REWIND and Press the RETURN Key. 

To start the tape at the beginning, type REWIND and press the RETURN 
key. The system moves the tape to the beginning and prints the DUMPER 
prompt: 

DUMPER>RE WIND (RED 
DUMPER> 
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^Step 170: 



Give the Command: 
PS :< OPERATORS 



RESTORE (TAPE FILES) PS :<*>*.*.* (TO) 



To restore the documents to directory PS: <OPERATOR> , type RESTORE and 
press the ESC key. The system prints (TAPE FILES). Type PS:. Press 
the ESC key. The system prints <*>*.*.* (TO). Type PS: <OPERATOR> and 
press the RETURN key. The system prints a header containing the date 
and time that the tape was made, followed by the DUMPER prompt. If 
you want a list of the files, give the FILES command before the 
RESTORE command. You can restore the files to any directory. 
PS:<OPERATOR> is not required. 



I 
DUMPER>RESTORE (TAPE FILES) PS: <*>*.*.* (TO) PS : <OPERATOR> © 

DUMPER TAPE # 1, <DOCUMENTS> , WEDNESDAY, 5-MAR-82 1741 
LOADING FILE(S) INTO PS : <OPERATOR> 

END OF SAVESET 
DUMPER> 



Error: If you do not see the message LOADING FILE(S) INTO 
PS:<OPERATOR>, no files are being restored from tape. 
Rewind the tape and try again. Be sure you have the correct 
tape mounted and the tape drive is on line. If problems 
persist, contact your DIGITAL Field Service Representative. 

You can list any of the files on the line printer by typing CTRL/C and 
giving the PRINT command. The files with file types .MEM, .BWR, .BD, 
•SD, .DOC, .TCO, and .PCO are the most useful to print. Return to 
DUMPER by giving the CONTINUE command and pressing the RETURN key 
twice. In the example, the user prints the file SOURCE. DIR: 

(CJRLJc] 

i 
DUMPER>~C 
$PRINT (FILES) 
$CONTINUE(RED 

m 

DUMPER> 



SOURCE.. DIR <m 



W^ Step 171: Give the Command: RESTORE (TAPE FILES) PS:<*>*.*.* (TO) 
PS:<SUBSYS>. 

To restore the binary files to PS:<SUBSYS>, type RESTORE and press the 
ESC key. The system prints (TAPE FILES). Type PS:. Press the ESC 
key. The system prints <*>*.*.* (TO). Type PS:<SUBSYS> and press the 
RETURN key. The system prints the header, followed by the DUMPER 
prompt: 

(ESC) fs§ 

DUMPER>RESTORE (TAPE FILES) PS: <*>*.*.* (TO) PS:<SUBSYS>© 

DUMPER TAPE # 1, <BINARY> , WEDNESDAY, 5-MAR-82 1743 
LOADING FILE(S) INTO PS:<SUBSYS> 

END OF SAVESET 
DUMPER> 
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W^ Step 172: Sources. 

If you want to restore the source files, give the same RESTORE command 
as in the last step; but replace <SUBSYS> with the name of the 
directory where you want the sources stored. Normally, the 
directories in the definition of the system logical name SYS: do not 
contain source files, so you should use the CTRL/E CREATE command to 
create appropriate directories for the source files. 

^Step 173: Dismount the Tape and Store It. 

Remove the tape from the drive and store it in a safe place. 

t^ Step 174: Go to Step 168 to Restore Other Software Products. 

Go back to Step 168 if you want to install other software products. 

^Step 175: Give the DUMPER Command: EXIT. 

Type EXIT and press the RETURN key to end DUMPER. Return to TOPS-20 
command level: 

DUMPER> L :XIT RET) 

$ 

^ Step 176: Give the Command: DEASSIGN (DEVICE) MTAn:. 

Give the DEASSIGN command to release the magnetic tape for use by 
other users. Type DEASSIGN and press the ESC key. The system prints 
(DEVICE) . Type MTAn: (or the number of the magnetic tape drive that 
you are using) and press the RETURN key. The system prints the 
TOPS-20 prompt: 



$ REASSIGN (DEVICE) MTAO : iREfl 
$ 



^Step 177: Proceed to Step 178 in Chapter 7, 
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CHAPTER 7 
RUNNING THE TOPS-20 UETP PACKAGE 



This chapter describes how to run the User Environment Test 
This program performs a cursory check of the system. 



Package , 



This program starts a number of tests that can run either once or 
repeatedly. The source files are kept in the directory <UETP.LIB>, 
while the temporary data files and results of the test are stored in 
the directory <UETP.RUN>. For more information on UETP, refer to the 
User Environment Test Package Reference Manual. 



NOTE 

If you performed the steps in Chapter 6 
of this manual, you may skip Steps 178 
through 180 and start at Step 181. You 
should perform all the steps in this 
chapter on the operator's console 
terminal (CTY) . Otherwise, you must 
return to the CTY after completing the 
steps in this chapter to resume control 
of the system. 



W^ Step 178: Type CTRL/C. 

Type a CTRL/C to start a job. 



(CTRL/C) 

Installation-test System, TOPS-20 Monitor 5(3117) 

e 



^Step 179: Give the Command: LOGIN (USER) OPERATOR (PASSWORD) 
Password (ACCOUNT) OPERATOR and Press the RETURN Key. 



Your 



From this terminal, log into the system as OPERATOR, using your 

password and the account OPERATOR. Type LOGIN and press the ESC key. 
The system prints (USER) . Type OPERATOR and press the ESC key. The 

system prints (PASSWORD) . Type your password and press the ESC key. 

The system prints (ACCOUNT) . Type OPERATOR and press the RETURN key. 

I I I 

@LOGIN (USER) OPERATOR (PASSWORD) your password (ACCOUNT) OPERATOR (RET) 
JOB 6 ON TTY1 8-SEP-81 13:51 

@ 
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W^ Step 180: Give the Command: ENABLE (CAPABILITIES) and Press the 
RETURN Key. 

To enable your capabilities, type ENABLE and press the ESC key. The 
system prints (CAPABILITIES). Press the RETURN key. 

ID 
I 
^ENABLE (CAPABILITIES)® 
$ 

+ Step 181: Give the Command: TAKE (COMMANDS FROM) PS : <UETP.LIB> 
SET-UP. CMD and Press the RETURN Key. 

To set up various subdirectories, type TAKE and press the ESC key. 
The system prints (COMMANDS FROM}. Type PS : <UETP.LIB>SET-UP.CMD and 
press the RETURN key. This command file contains all the commands 
necessary to create the subdirectories. 

(ESC) 
i 
$TAKE (COMMANDS FROM) PS : <UETP. LIB>SET-UP . CMD (50) 

[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
[NEW] 
END OF <UETP.LIB>SET-UP.CMD.3 

^Step 182: Give the Command: CONNECT (TO DIRECTORY) PS: <UETP.RUN> and 
Press the RETURN Key. 

To connect to the directory that has the standard tests, type CONNECT 
and press the ESC key. The system prints (TO DIRECTORY) . Type 
PS:<UETP.RUN> and press the RETURN key. 

I 
$CONNECT (TO DIRECTORY) PS : <UETP. RUNXH) 
$ 

W^ Step 183: Give the Command: RUN (PROGRAM) UETP. EXE and Press the 
RETURN Key. 

To start the UETP program, type RUN and press the ESC key. The system 
prints (PROGRAM). Type UETP. EXE and press the RETURN key. The system 
prints the prompt UETP>. 

W 
i 
$RUN (PROGRAM) UETP. EXE (RET) 
[ l-Nov-81 9:41:45 USER ENVIRONMENT TEST PACKAGE ] 

UETP> 
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^ Step 184: Load the Standard Verification Tests. 
Type : 

TAKE (COMMANDS FROM) VERIFY . CMD (RJT) 

This command causes the standard tests to be loaded and the first test 
(VERIFY) to begin. The following messages are typed out: 

UETP>ENABLE VERIFY/CYCLE : 1 ! Verify that the correct software 
[hh:mm:ss ENABLE COMPLETED] 

UETP>BEGIN ! is installed 

[hh:mm:ss BEGIN COMPLETED] 

UETP>DEFAULT/CYCLE : 00 : 1 5 
[hh:mm:ss DEFAULT COMPLETED] 

UETP>ENABLE RANCBL 
[hh:mm:ss ENABLE COMPLETED] 

UETP>ENABLE RANFOR 
[hh:mm:ss ENABLE COMPLETED] 

UETP>ENABLE MTAO 

[hh:mm:ss ENABLE COMPLETED] 

The field hh:mm:ss contains the time the message was generated. 

Following these messages, the system prints the following status 
information : 

[ 5-MAR-82 9:42:47] 

Test Depth Status Cycle Times Error Error Start 
name run count limit time 

VERIFY VER 

RANCBL VER 

RANFOR VER 

MTAO VER 

The next two messages you see are 

START VERIFY 9:43:33 
END VERIFY 10:14:53 

The messages signify the beginning and ending of the test. 

NOTE 

If any messages appear between the start 
message and the end message, there are 
errors in the files you received. Do 
net proceed any further. 



Queued 


1 











dd-mmm-yy hh:mm:ss 


Enabled 


0:15 













Enabled 


0:15 













Enabled 


0:15 
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If the first test (VERIFY) finishes without error, go on to Step 185. 

NOTE 

In the following steps you should use a 
tape drive that is not presently 
available to timesharing users. If you 
have just completed the steps in Chapter 
6 of this manual, you can give the 
TOPS-20 ASSIGN command to assign the 
drive that you deassigned in Step 176. 
Otherwise, perform Steps 160 through 164 
in Chapter 6 before continuing with Step 
185 below. 

^ Step 185: Mount a Magnetic Tape on the Drive You Want to Test. 

Test MTAO requires that a blank magnetic tape be mounted on drive 0. 
Be sure that a write ring has been inserted in the tape and that the 
drive is on line before you issue the BEGIN command. 



NOTE 

The standard tests incl 
COBOL test, a random 
and a magtape test for 
want to test a tape 
drive 0, you must enabl 
the selected drive, 
press the ESC key. Th 
(TEST) . Type MTAn ( 
the drive, e.g., MTA1 , 
the RETURN key. 



ude a random I/O 

I/O FORTRAN test, 

MTAO:. If you 

drive other than 

e the test for 

Type ENABLE and 

e system prints 

n = the number of 

MTA2) and press 



1 
UETP>ENABLE (TEST) MTAn (RE 

Wp Step 186: Begin the Remaining Tests. 

Type : 

BEGIN IRET; 

The system prints the following messages: 

START RANCBL hh:mm:ss 
START RANFOR hh:mm:ss 
START MTAO hh:mm:ss 

END RANCBL hh:mm:ss 
END RANFOR Hh:mm:ss 
END MTAO hh:mm:ss 
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If messages other than those shown above appear, the tests generating 
the messages have failed. 

When all tests are completed, the following status information 
appears : 



[All tests complete on processor # 2102] 



[ l-Nov-81 10:26:01] 



Test 
name 



Depth Status 



Cycle Times Error Error Start 
run count limit time 



VERIFY VER 

RANCBL VER 

RANFOR VER 

MTAO VER 



Ended 


1 


1 





Ended 


0:15 


1 





Ended 


0:15 


1 





Ended 


0:15 


1 






5-MAR-8 2 9:42:33 

5-MAR-82 10:15:46 

5-MAR-82 10:15:46 

5-MAR-82 10:15:46 



NOTE 

At this point you can either type an 
EXIT command to terminate UETP, or begin 
the tests for the optional software. 
The following step (Step 187) shows how 
to terminate UETP. If you want to test 
the optional software, you should skip 
Step 187 and proceed to Step 188. 



^Step 187: Type EXIT 



7.1 TESTING SOFTWARE 

The steps in this section describe how to enable tests for optional 
software products. Be sure to enable tests only for the optional 
software products you have installed. 



W^ Step 188: If You Have Installed BASIC-PLUS-2, Give the 
ENABLE (TEST) BASIC and Press the RETURN Key. 



Command : 



If you have installed BASIC-PLUS-2, type ENABLE and press the ESC key. 
The system prints (TEST) . Type BASIC and press the RETURN key. 

UETP>ENABLE (TEST) BASIC®) 

10:43:07 [ENABLE COMPLETED] 
UETP> 



7-5 



RUNNING THE TOPS-20 UETP PACKAGE 



W^ Step 189: 



If You Have Installed ALGOL, Give the Command: ENABLE 
(TEST) ALGOL and Press the RETURN Key. 



If you have installed ALGOL-20, type ENABLE and press the ESC key. 
The system prints (TEST) . Type ALGOL and press the RETURN key. 

He 
1 

UETP>ENABLE (TEST) ALGOL© 

10:43:07 [ENABLE COMPLETED] 
UETP> 

■^ Step 190: If You Have Installed DBMS-20, Give the Command: ENABLE 
(TEST) DBMS and Press the RETURN Key. 

If you have installed DBMS-20, type ENABLE and press the ESC key. The 
system prints (TEST) . Type DBMS and press the RETURN key. 



UETP>ENABLE (TEST) DBMS (MI) 

10:43:07 [ENABLE COMPLETED] 
UETP> 



Step 191: If You Have Installed APL-20, Give the Command; 
(TEST) APL and Press the RETURN Key. 



ENABLE 



If you have installed APL-20, type ENABLE and press the ESC key. The 
system prints (TEST). Type APL and. press the RETURN key. 



i 



UETP>ENABLE (TEST) APL (Hi 

10:43:07 [ENABLE COMPLETED] 
UETP> 



^ Step 192; 



Give the Command; 
RETURN Key. 



BEGIN (UETP RUN AFTER) and Press the 



To begin the standard tests and all the optional software tests you 
enabled, type BEGIN and press the ESC key. The system prints (UETP 
RUN AFTER) . Press the RETURN key. The system starts all the tests 
immediately. 

(ESC) 

UETP>BEGIN (UETP RUN AFTER) (rD 
10:45:17 [BEGIN COMPLETED] 

UETP> 



NOTE 

Periodically give a STATUS command to 
find out which tests are running and how 
many times they have been run. The 
following is an example of the STATUS 
command : 
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UETP>STATUSgn) 
[l-Nov-81 11:02:05] 



Test 


Dep 


name 




====== 


= = = : 


VERIFY 


VER 


RANCBL 


VER 


RANFOR 


VER 


MTAO 


VER 



Depth Status Cycle 



Ended 1 

Running 0:15 

Queued 0:15 

Queued 0:15 



Times 
run 

1 






Error Error Start 
count limit time 



5-MAR-82 10:42:20 

5-MAR-82 10:59:27 

5-MAR-82 10:59:27 

5-MAR-82 10:59:27 



UETP> 



From the above example you can see that the RANCBL. SUP test is 
running, the RANFOR. SUP and MTAO. SUP tests are in a wait state, and 
the VERIFY. SUP test has ended. 

If under the heading ERROR COUNT there is a number other than 0, be 
sure to print the ERRORS.LOG file to find out what caused the error. 

The UETP program does not notify you when all the tests are completed. 
To find out when all the tests are completed, give a STATUS command. 
When all the tests are completed, your output from the STATUS command 
resembles the following: 

STATUS® 



[ l-Nov-81 11:40::45] 

Test Depth Status 
name 



Cycle Times Error Error Start 
run count limit time 



VERIFY 


VER 


Ended 


1 


1 





RANCBL 


VER 


Ended 


0:15 


1 





RANFOR 


VER 


Ended 


0:15 


1 





MTAO 


VER 


Ended 


0:15 


1 






5-MAR-82 10:42:20 

5-MAR-82 10:59:27 

5-MAR-82 10:59:27 

5-MAR-82 10:59:27 



W^ Step 193: Give the Command: EXIT and Press the RETURN Key. 

To exit from the UETP program, type EXIT and press the RETURN key. 
The system prints the TOPS-20 enabled prompt. 

UETP>EXIT(H) 
$ 

Error: If you try to exit while there are tests still running, the 
ERROR: system prints the message %YOU STILL HAVE TESTS RUNNING. 

"ABORT ALL" BEFORE EXITING. Wait until all the tests are 

completed and then reissue the EXIT command. 
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Give the Command: TAKE (COMMANDS 
CLEAN-UP. CMD and Press the RETURN Key. 



FROM) 



<UETP.LIB> 



To delete the temporary directories, type TAKE and press the ESC key. 
The system prints (COMMANDS FROM). Type <UETP.LIB>CLEAN-UP.CMD and 
press the RETURN key. The system prints the word [OLD] for each 
directory it has deleted. 

iESi;j 

T 

$TAKE (COMMANDS FROM) <UETP . LIB>CLEAN-UP .CMDdS 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
End Of <UETP.LIB>CLEAN-UP.CMD.3 



NOTE 

If you did not perform the steps in 
Chapter 6 before proceeding to the steps 
in this chapter, you cannot return to 
the OPR program (Step 195). Instead, 
perform Steps 157 through 159 in Chapter 
6 at this time. Then you can skip Step 
195 and continue with Step 196, below. 



^Step 195: Type POP. 



To return the CTY to the OPR program, type POP. 
OPR prompt. 

$ pop dm 

OPR> 



The system prints the 



^ Step 196: Start Timesharing, 



NOTE 



If you performed Steps 161 and 162 in 
Chapter 6, you should now give the SET 
TAPE-DRIVE MTAO: AVAILABLE command to 
the OPR program. This command returns 
the tape drive you were using to the 
pool of available resources. 
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APPENDIX A 
UPDATING THE DECSYSTEM-20 TO TOPS-20 VERSION 5.1 SOFTWARE 



This appendix describes how to install Version 5.1 software on a 
DECSYSTEM-20 now running TOPS-20 Version 5 software. 

As you update the system, enter the commands printed in red. The 
system's replies are printed in black. 

The updating procedures are divided into four sections. They are: 

• INSTALLING THE VERSION 5.1 SOFTWARE (Section A.l) 

• REVERTING TO VERSION 5 (Section A. 2) 

• MAKING THE VERSION 5.1 MONITOR THE PRIMARY MONITOR (Section 
A. 3) 

• MAKING THE VERSION 5.1 MONITOR THE PERMANENT MONITOR (Section 

A. 4) 

The steps in this Appendix assume you are using the CTY. 



A.l INSTALLING THE VERSION 5.1 SOFTWARE | 

To install the TOPS-20 Version 5.1 software, you need: | 

• System Floppy A 

• System Floppy B 

• System Floppy C, which should be used for new installations 
only . If you are updating your software from a previous 
version, DO NOT USE Floppy C. 

• TOPS-20 Installation Tape V5.1 

• RP20 Microcode Tape (RP20 only) 

• A separate tape for each optional software product you have 
purchased. 
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^Step 1: Log in to the System with OPERATOR or WHEEL Capabilities. 

0*0 GE) GO 

LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) account C^F) 

NOTE 

If you are usinq the OPR program at the 
CTY, you can give the PUSH command to 
OPR instead of logging in another job. 
The PUSH command to OPR puts you at 
TOPS-20 command level. Below is an 
example of giving the PUSH command to 
OPR at the CTY and performing Step 2: 

OPR>PUSHQiD 

1 TOPS-20 Command processor 5.1(1640) 

( ESC ) 

^INFORMATION (ABOUT) DISK-USAGE (jiT) 
n pages assigned 

n Working pages, n Permanent pages allowed 
n Pages free on PS: 



^•Step 2: Give the Command: INFORMATION (ABOUT) DISK-USAGE and Press 
the RETURN Key. 

You must have enough disk space on your public structure (PS:) before 
you can proceed. To find out how many free pages there are on PS:, 
type INFORMATION and press the ESCAPE key. The system prints (ABOUT); 
type DISK-USAGE and press the RETURN key. The system prints the 
number of pages assigned to you and the number of free pages on PS:. 

^INFORMATION (ABOUT) DISK-USAGE fSp 
The system prints 

n pages assigned 

n Working pages, n Permanent pages allowed 
n Pages free on PS: 
9 

Where n = the number of pages 

NOTE 

The number of free pages on PS: must be 
at least 5000. If you do not have at 
least this number of pages free, you 

I must dump some files to tape or delete 

and expunge some files. 
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^Step 3: Give the Command: ENABLE (CAPABILITIES). 

@ENABLE (CAPABILITIES) QjO 



^Step 4: Give the Command: TAKE PS:<UETP.LIB>CLEAN-UP.CMD and Press 
the RETURN Key. 

To delete various directories created by the UETP program, type TAKE 
PS:<UETP. LIBXZLEAU-UP.CMD and press the RETURN key'. 

$TAKE PS : <UETP . LIB>CLEAN-UP. CMD C^T) 
$ 

^Step 5: Give the Command: "ECREATE (DIRECTORY NAME) PS:<DETP.LIB> 
and Press the RETURN Key. 

Before you can load the Version 5.1 UETP program onto PS:, you must 
delete the Version 5 PS :<UETP. LIB> directory. Type CTRL/E CREATE and 
press the ESC key. The system prints (DIRECTORY NAME). Type 
PS:<UETP.LIB> and press the ESC key. The system prints (PASSWORD). 
Press the RETURN key. 



* i J 

$ ECREATE (DIRECTORY NAME) PS : <UETP. LIB> (PASSWORD ) (~^T) 

[OLD] 
$$ 

^Step 6: Give the Command: KILL and Press the RETURN Key. 

To delete the Version 5 PS : <UETP.LIB> directory, type KILL and press I 

the RETURN key. The system prints [CONFIRM]. ' " I 

$$KILLdT) 
[CONFIRM] 

^Step 7: Press the RETURN Key Twice. 

To confirm you are deleting the directory PS : <UETP.LIB> , press the 
RETURN key twice. 



[C0NFIRM]Qei 

$$dD 

$ 
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►Step 8: Kill Directories PS: <UETP.RUN> and PS:<DETP> in the Same 
Manner. 



$ '-.CiiEATR PS:<UETP. RUN>( irr) 

[OLD] 

$$KTT.lCmQ 

[CONFIRM] Q»Vj 

$$c«o 

i 

$" - "PEATE PS :<UETP>Qft ) 
[OLD] 

$$KILLC'*i-0_ 
[CONFIRM] ' v 1Tr> 

$ S ; rtn_J> 

$ 

^Step 9: Give the Command: DELETE PS: <SPOOL>PRIMARY-MASTER-QUEUE-FILE 
.QUASAR and Press the RETURN Key. 

After allowing any pending jobs to complete or after sending messages 
to their owners asking them to re-submit them later, you must delete 
the master spooling file in preparation for the batch and spooling 
(GALAXY) system. Type DELETE PS : <SPOOL>PRIMARY- and press the ESCAPE 
key. The system prints MASTER-QUEUE-FILE. QUASAR. 1 and gives a message 
verifying the deletion. 

Q3D 
I 

$DELETE PS : <SPOOL>PRIMAFY- MASTEP-QUEUE-FILE . QUASAFQFT) 

PS : <SPOOL>PFIMARY-MASTER-QUEUE-FILE .QUASAR. 1 [OK] 

$ 

NOTE 

If you gave a PUSH command to OPR, at 
the CTY give a POP command to return to 
OPR command level, and perform Steps 11 
through 14. Otherwise, perform Steps 10 
through 14. 

If you have tape drive allocation 
enabled, perform Steps 10 through 13. 
Otherwise, continue at Step 15. 

^Step 10: Give the Command: OPR and Press the RETURN Key 

To place yourself at OPR command level, type OPR and press the RETUF"! 
key. The system prints the prompt OPR>. 



OPR> 
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^Step 11: Give the OPR Command: SHOW STATUS TAPE-DRIVES /ALL and 
Press the RETURN Key 

To find out what drives on the system are available to mount the 
Installation Tape, give the OPR command SHOW STATUS TAPE-DRIVES /ALL. 
The system prints the status of all tape drives on the system and then 
prints the prompt OPR> again. 

Any tape drive that has the status of "UNLOADED" can be used for 
mounting the Installation tape. 



OPR>SHOW STATUS TAPE-DRIVES /ALLGJD 
OPR> 

10:13:09 — Tape Drive Status-- 

DRIVE STATE VOLID REQ# JOB# USER 



MTAO: Available 
MTA1: Unloaded 

AVR: Yes 
MTA2: Unloaded 

AVR: Yes 
MTA3: Unloaded 

AVR: Yes 
MTA5: Unloaded 

AVR : Ye s 
MTA6: Unavailable 
MTA7: Unavailable 



^Step 12: Give the OPR Command: 
Press the RETURN Key. 



SET TAPE-DRIVE MTAn UNAVAILABLE and 



To mount the TOPS-20 Installation Tape, you should first make an 
available tape drive unavailable to timesharing users. To do this, 
give the OPR command SET TAPE-DRIVE MTAn UNAVAILABLE, and press the 
RETURN key. The system prints Enter text and terminate with ~Z. Type 
Installing Version 5.1 Software and type a CTRL/Z . The system prints 
the prompt OPR>. 



The example uses MTAO: as the tape drive, but 
tape drive that is not in use at the moment. 



you can specify any 



G*D 

OPR>SET TAPE-DRIVE MTAO: UNAVAILABLEQjT) 
Enter text and terminate with ~Z 
Installing Version 5.1 Software <s™~ 

OPR> 
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^Step 13: Give the OPR Command: PUSH and Press the RETURN Key. 

To install the Version 5.1 software, you should be at TOPS-20 command 
level. To place yourself at TOPS-20 Command level, type PUSH to OPR 
and press the RETURN key. The system prints TOPS-20 command Processor 
I 5(712) and then the prompt @. 



OPR>PUSHQeJ 
I TOPS-20 Command Processor 5.1(1640) 
8 

^Step 14: Give the Command: ENABLE (CAPABILITIES) and Press the 
RETURN Command. 

To enable your capabilities, type ENABLE and press the ESCAPE key. 
The system prints (CAPABILITIES). Press the RETURN key. The system 
prints the $ prompt. 



ESC 
I 

@ENABLE (CAPABILITIES) QtD 
$ 

^Step 15: Give the Command: ASSIGN (DEVICE) MTAO: and Press the 
RETURN Key. 

To assign tape drive to your job, type ASSIGN and press the ESCAPE 
key. The system prints (DEVICE). Type MTAO: and press the RETURN 
key. The system prints the $ prompt. 

GE3 
1 
$ASSIGN (DEVICE) MTAO: C^P) 

$ 

^Step 16: Mount the Installation Tape on MTAO: and Give the Following 
Commands: 

' ESC ) 

$REWIND (DEVICE) MTAO : GID 

I 

$SKIP (DEVICE) MTAO: 2 FILES fiiT) 

^Step 17: Give the Command: RUN (PROGRAM) MTAO: and Press the RETURN 
Key. 

To run the DLUSER program from magnetic tape, type RUN and press the 

ESCAPE key. The system prints (PROGRAM). Type MTAO: and press the 

RETURN key. After the DLUSER program starts, the system prints the 
DLUSER prompt. 

GiD 

$RUN (PROGRAM) MTAO : GID 
DLUSER> 
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Error: If you make a typing mistake, rewind the tape, skip two 
files, and reissue the command above. The following example 
shows how to do this when the Installation tape is on MTAO:. 



$REWIND (DEVICE) MTAO : ( ret ) 

$SKIP (DEVICE) MTAO: 2 FILESQel) 

$RUN (PROGRAM) MTAO: ( "" j 
DLUSER> 

^Step 18: Give the DLUSER Command: LOAD (FROM FILE) MTAO: and Press 
the RETURN Key. 

To load the parameters for the directories <UETP> and <SYSTEM-ERROR> 
into the file system from the TOPS-20 Installation tape, type LOAD and 
press the ESCAPE key. The system prints (FROM FILE). Type MTAO: and 
press the RETURN key. After a few seconds, the system prints 
DONE, and gives the DLUSER prompt. 

DLUSER>LOAD (FROM FILE) MTAO : GJD 

The system prints 

DONE. 
DLUSER> 

^Step 19: Type EXIT and Press the RETURN Key. 

Type EXIT and press the RETURN key to leave the DLUSER program. The 
system prints the TOPS-20 enabled prompt. 

DLUSER>EXIT ( ret ) 
$ 

^Step 20: Give the Command: RUN (PROGRAM) MTAO: and Press the RETURN 
Key. 

To run the DUMPER program, type RUN and press the ESCAPE key. The 
system prints (PROGRAM). Type MTAO: and press the RETURN key. After 
the DUMPER program starts, the system prints the DUMPER prompt. 

$RUN (PROGRAM) MTAO: C^O 
The system prints 
DUMPER> 
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Error: If you receive any errors, rewind the tape, skip four files 
and reissue the command above. The following example shows 
how to do this for MTAO:. If errors still persist, contact 
DIGITAL Software Support. 



i 

$REWIND (DEVICE) MTAO: (TF 



1 

$SKIP (DEVICE) MTAO: 4 FILES (JK) 

i 
$RUN (PROGRAM) MTAO: (~i^~) 

The system prints 

DUMPER> 

^Step 21: Give the DUMPER Command: TAPE (FILESPEC) MTAO: and Press 
the RETURN Key. 

To tell the DUMPER program which tape drive you are using, type TAPE 
and press the ESC key. The system prints (FILESPEC). Type MTAO: and 
press the RETURN key. The system prints the DUMPER prompt. 

CIED 

DUMPERXTAPE (FILESPEC) MTAO: Qjf) 
The system prints 
DUMPER> 

^Step 22: Give the DUMPER Command: FILES and Press the RETURN Key. 

To have the files being restored into the individual directories typed 
on your terminal, type FILES and press the RETURN key. The system 
prints the DUMPER prompt. 

DUMPER>FILESQTT) 
DUMPER> 

^Step 23: Give the Command: RESTORE (TAPE FILES) PS:<*>*.*.* (TO) 
PS:<NEW-SYSTEM> and Press the RETURN Key. 

To copy the TOPS-20 monitor and its related programs from the 
Installation tape to your public structure, type RESTORE and press the 
ESC key. The system prints (TAPE FILES). Type PS: and press the ESC 
key. The system prints <*>*.*.* (TO). Type PS : <NEW-SYSTEM> and press 
the RETURN key. 
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This DUMPER command restores all the files in the first saveset to the 
directory PS : <NEW-SYSTEM> . When all the files are restored, the 
system prints the message END OF SAVESET and the DUMPER prompt. 

J 1 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <NEW-SYSTEM> QF) 



DUMPER TAPE #1, "NEW-SYSTEM FOR Version 5.1", THURSDAY, 2-AUG-81 2136 
LOADING FILE(S) INTO PS : <NEW-SYSTEM> 

END OF SAVESET 
DUMPER> 

^Step 24: Give the Command: RESTORE (TAPE FILES) PS :<*>*.*.* (TO) 
PS:<NEW--SUBSYS> and Press the RETURN Key. 

Restore the system program files to the directory PS :<NEW-SUBSYS>. 
Type RESTORE and press the ESC key. The system prints (TAPE FILES). 
Type PS: and press the ESC key. The system prints <*>*.*.* (TO). 
Type PS:<NEW-SUBSYS> and press the RETURN key. When all the files are 
restored, the system prints the message END OF SAVESET and the DUMPER 
prompt. 

Gl s D G?D 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <NEW-SUBSYS> C^O 

DUMPER TAPE #1, "SUBSYS FILES FOR TOPS-20 V5.1" THURSDAY, 2-AUG-81 2136 
LOADING FILE (S) INTO PS : <NEW-SUBSYS> 

END OF SAVESET 
DUMPER> 



^Step 25: Give the DUMPER Command: RESTORE (TAPE FILES) PS :<*>*.*, 
(TO) PS:<UETP.LIB>*.*.* and Press the RETURN Key. 



* 



To restore the files for the User Environment Test Package, type 
RESTORE and press the ESC key. The system prints (TAPE FILES). Type 
PS: and press the ESC key. The system prints <*>*.*.* (TO). Type 
PS:<UETP.LIB> and press the ESC key. The system prints *.*.*. Press 
the RETURN key. When all the files are restored, the system prints 
END OF SAVESET and the DUMPER prompt. 



DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <UETP. LIB> * . * . * Q? 



DUMPER TAPE #1, "UETP FILES FOR TOPS-20 V5.1", THURSDAY, 2-AUG-81 2136 I 
LOADING FILE(S) INTO PS : <UETP . LIB> 1 

END OF SAVESET 
DUMPER> 
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^Step 26: Give the DUMPER Command: RESTORE (TAPE 
(TO) PS:<NEW-SUBSYS>*.*.* 



FILES) PS:<*>*.*.* 



To restore the GALAXY files into the directory PS :<NEW-SUBSYS>, type 
RESTORE and press the ESC key. The system prints (TAPE FILES). Type 
PS: and press the ESC key. The system prints <*>*.*.* (TO). Type 
PS:<NEW-SUB and press the ESC key. The system prints SYS>*.*.*. 
Press the RETURN key. When all the files are restored, the system 
prints END OF SAVESET and the DUMPER prompt. 



I 



I J 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <NEW-SUBSYS> * . * . * CE£) 
1 DUMPER TAPE #1, "GALAXY V4 . 2 NEW-SUBSYS FILES FOR TOPS-20 V5.1 TUESDAY 
21-JUL-81 2015 
Loading file(s) into PS :<NEW-SUBSYS> 

End of saveset 
| DUMPER> 



NOTE 



I 



If you have an RP20 disk system, perform 
the procedures in Steps 27 to 29. 
Otherwise, continue the installation 
process at Step 30. 



^Step 27: Give the DUMPER Command: UNLOAD and Press the RETURN Key. 

| To unload the Version 5.1 Installation Tape from the tape drive, give 
the DUMPER command UNLOAD and press the ESCAPE key. The system prints 
(DEVICE). Type MTAO : and press the RETURN key. The system rewinds 
and unloads the tape from the drive. 

DUMPER>UNLOAD(~ST) 

DUMPER> 



^Step 28: Dismount the Installation Tape and Mount the RP20 
Tape . 



Microcode 



^Step 29: Give the DUMPER Command: RESTORE (TAPE FILES) 
(TO) PS:<NEW-SUBSYS> and Press the RETURN Key. 



PS:<*>*.*.* 



After you have mounted the RP20 Microcode Tape on MTAO, give the 
DUMPER command. RESTORE and press the ESC key. The system prints 
(TAPE FILES). Type PS: and press the ESC key. The system prints 
<*>*.*.*. (TO). Type PS:<NEW-SUBSYS> and press the ESC key. The 
system prints *.*.*. Press the RETURN key. After all the file(s) are 
restored, the system prints END OF SAVESET and then the DUMPER prompt. 



\ \ 

DUMPER>RESTORE (TAPE FILES) PS :<*>*.*.* 



(TO) PS:<NEW-SUBSYS 






r^o 



DUMPER TAPE #1, "RP20 MICROCODE FOR Version 5.1, THURSDAY 21-JUNE-81 2136" 
LOADING FILE(S) INTO PS : <NEW-SUBSYS> 

END OF SAVESET 
DUMPER> 
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^Step 30: Give the DUMPER Command: EXIT and Press the RETURN Key. 

To terminate the DUMPER program and return to the TOPS-20 command 
level, type EXIT and press the RETURN key. 

DUMPER>EXITQiD 
$ 

^Step 31: Give the Command: UNLOAD (DEVICE) MTAO: and Press the 
RETURN Key. 

To rewind and unload the tape on MTAO:, type UNLOAD artd press the ESC 
key. The system prints (DEVICE). Type MTAO: and press the RETURN 
key. 

C ESC ) 

I 

$UNLOAD (DEVICE) MTAO : QeT) 

$ 

^Step 32: Give the Command: DEASSIGN (DEVICE) MTAO: and Press the 
RETURN Key. 

To remove the device MTAO: from your job, type DEASSIGN and press the 
ESC key. The system prints (DEVICE). Type MTAO: and press the 
RETURN key. The system prints the $ prompt. 



I 

$DEASSIGN (DEVICE) MTAO : (j^ 

$ 



NOTE 



If you performed Step 12, which removed 
a tape drive from system's usage, 
perform Steps 33 through 36. Otherwise, 
continue at Step 37. 

^Step 33: Give the Command: POP and Press the RETURN Key. 

To return to OPR command level, type POP and press the RETURN key. 
The system prints the prompt OPR> 

$POPC^P) 

OPR> 

^Step 34: Give the OPR Command: SET TAPE-DRIVE MTAn: AVAILABLE and 
Press the RETURN Key. 

To return the tape drive you removed from system usage in Step 12, 
give the OPR command SET TAPE-DRIVE MTAn: AVAILABLE and press the 
RETURN key. MTAO: is used in the example: 

OPR>SET TAPE-DRIVE MTAO: AVAILABLE C*" 



TOPS-20 Version 5.1 A-ll December 19 82 



UPDATING THE DECSYSTEM-20 TO TOPS-20 VERSION 5.1 SOFTWARE 

^Step 35: Give the OPR Command: PUSH and Press the RETURN Key. 

To return to TOPS-20 command level and continue the installation 
procedures, type PUSH and press the RETURN Key. The system prints the 
Command Processor's Version number and the @ prompt. 

OPR>PUSHC«" 



! TOPS-20 Command Processor 5.1(1640) 
9 

^Step 36: Give the Command: ENABLE (CAPABILITIES) and Press the 
Return Key. 

To enable your capabilities, type ENABLE and press the ESC key. The 
system prints (CAPABILITIES). Press the RETURN key. The system 
prints the $ prompt. 



@ENABLE (CAPABILITIES) QED 
c 



A. 1.1 Renaming the Version 5 Monitor 

In case you ever need to revert to the Version 5 monitor, you must 
rename it before copying the Version 5.1 monitor into 
<SYSTEM>MONITR.EXE. 

►Step 37: Give the Command: RENAME (EXISTING FILE) 
PS:<SYSTEM>MONITR.EXE (TO) PS : <SYSTEM>5-MONITR. EXE and Press 
the RETURN Key. 

To rename and save the Version 5 monitor, type RENAME and press the 
ESC key. The system prints (EXISTING FILE). Type 
PS:<SYSTEM>MONITR.EXE and press the ESC key. The system prints (TO 
BE). Type PS:<SYSTEM>5-MONITR.EXE and press the RETURN key. When the 
rename is successfully completed, the system prints a message 
specifying that the file was renamed correctly. 

( est ) CUD 

$RENAME (EXISTING FILE) PS : <SYSTEM>MONITP . EXE (TO BE) 

PS :<SYSTEM>5-MONITR.EXE C«D 
<SYSTEM>MONITR.EXE.l => <SYSTEM>5-MONITR. EXE . 1 [OK] 
$ 
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^Step 38: Give the Command: COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE 
(TO) PS:<SYSTEM>MONITR.EXE and Press the RETURN Key. 

To copy the Version 5.1 monitor into PS:<SYSTEM>, type COPY and press 
the ESC key. The system prints (FROM). Type 
PS :<NEW-SYSTEM>montyp.EXE and press the ESC key. (Montyp designates 
the type of monitor you have selected for your system, for example 
2060-MONE-IG; refer to Chapter 2, Section 2.3 of this manual for 
information about choosing a monitor for your system.) The system 
prints (TO). Type PS :<SYSTEM>MONITR.EXE and press the RETURN key. 
When the copy is successfully completed, the system prints a message 
specifying that the file was copied correctly. 

( esc - ) (fiisr ) 

i i 

$COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE (TO) PS : <SYSTEM>MONITR. EXE C r7 D 

<NEW-SYSTEM>montyp.EXE. => <SYSTEM>MONITR. EXE . 1 [OK] 

$ 



A. 1.2 Creating the File <NEW-SYSTEM>5-l-CONFIG.CMD I 

You must create the file <NEW-SYSTEM>5-l-CONFIG.CMD to declare system | 
parameters . 

►Step 39: Give the Command: EDIT (FILE) PS:<SYSTEM>5-CONFIG.CMD.l I 
(OUTPUT AS) PS:<NEW-SYSTEM>5-l-CONFIG.CMD. | 

To edit PS :<SYSTEM>5-CONFIG.CMD and have the changes placed in { 
PS:<NEW-SYSTEM>5-l-CONFIG.CMD, type EDIT and press the ESC key. The 
system prints (FILE). Type PS : <SYSTEM>5-CONFIG.CMD and press the ESC 
key. The system prints the generation number of that file and (OUTPUT 
AS). Type PS:<NEW-SYSTEM>5-l-CONFIG.CMD and press the RETURN key. 
The system prints: EDIT: <SYSTEM>5-CONFIG.CMD and the EDIT prompt. 



$EDIT (FILE) PS:<SYSTEM>5-CONFIG.CMD.l (OUTPUT AS) 
PS:<NEW-SYSTEM>5-l-CONFIG.CMDC^F 



I 
I 

The system prints 

EDIT: <SYSTEM>5-CONFIG.CMD.l 1 

* 

^Step 40: Give the Edit Command: P~:* and Press the RETURN Key. 

To print the contents of PS : <SYSTEM>5-CONFIG. CMD, type P~:* and press 
the RETURN key. The system prints the entire 5-CONFIG.CMD file and | 
then the EDIT prompt. 

EDIT: <SYSTEM>5-CONFIG.CMD.l | 

*P" : * Cket") 
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A. 1.3 Changing System Parameters 

Read Chapter 3 of this manual (Tailoring the System), and make any 
changes to the system parameters that are necessary. Three parameters 
that must be added are the definitions for the logical names SYS:, 
SYSTEM:, and SERR:. Add the following commands to the 5-1-CONFIG.CMD 
file. 



DEFINE SYS: PS : <NEW-SUBSYS> , PS : <SUBSYS> QjJD 
DEFINE SYSTEM: PS : <NEW-SYSTEM> , PS : <SYSTEM> QiT 
DEFINE SERR: PS : <SYSTEM-ERROR> C5p 



NOTE 

When you are making a change to existing 
lines of the 5-CONFIG.CMD file, use the 
EDIT command R line number. Any changes 
made to the system parameters are made 
only in <NEW-SYSTEM>5-l-CONFIG.CMD. The 
| file <SYSTEM>5-CONFIG.CMD remains the 

same. 

^Step 41: Press the ESC Key, Type EU and Press the RETURN Key. 

After you make all the necessary changes to the system parameters, 
press the ESC key, type EU, and press the RETURN key. This command 
ends the EDIT program and saves the file. The system prints the name 
of the output file. 

*EU(j«D 

[<NEW-SYSTEM> 5-1 -CONFIG. CMD.l] 
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A. 1.4 Setting a User Group for the Operator 

You must be certain that the operator is a member of user group 100. 
Do so by giving the following command. 
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►Step 42: Give the Command: ~ECREATE (DIRECTORY NAME) PS : <OPERATOR> 
and Press the RETURN Key. 

Type CTRL/E CREATE and press the ESC key. The system prints 

(DIRECTORY NAME). Type PS : <OPEPATOR> and press the RETURN key. The 
system prints [Old], then the subcommand prompt. 



$~ECREATE (DIRECTORY NAME) PS : <OPERATOP> GID 

[Old] 

$$ 

^Step 43: Type USER 100 and Press the Return Key. 

At the subcommand prompt type USER, press the space bar, then type 
100. Press the RETURN key. 

$$USER 10 C*"~) 
$$ 

^Step 43A: Give the subcommand: IPCF and Press the RETURN key. 



$ $ I PC f GED 

$$ 

^Step 44: Press the RETURN Key. 

To exit from the subcommand level, press the RETURN key. 



$ 

^Step 45: Give the Command: "ECEASE (TIMESHARING AT) +1 (RESUMING AT) 
Date and Time and Press the RETURN Key. 

To bring the system down, type CTRL/E CEASE and press the ESC key. 

The system prints (TIMESHARING AT). Type +1 and press the ESC key. 

The system prints (RESUMING AT) . Type the date and time and press the 
RETURN key. 

(( IKI..I.) ( ESC j ( KM ) 

I i I 

$~ECEASE (TIMESHARING AT) +1 (RESUMING AT) date and time(jT 
System shutdown scheduled for 2-SEP-81 13:47:00, 
System going down in one minute!! 
System down, up again at 2-SEP-81 13:48:00 

Shutdown complete 

NOTE 

Wait for the system to print Shutdown 
complete. 
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^Step 46: Type CTRL/V 

At the console terminal, type CTRL/\ to return to the front-end 
Command Parser. When you are at Command Parser command level, the 
system prints the prompt PAP>. 

Shu tdown complete 
(77k7_) 

PAR> 

^Step 47: Type SHUTDOWN and Press the RETURN Key. 

To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key. 
The system prints a list of messages. 

PAR>SHUTDOWN C^H 

** HALTED ** 

%DECSYSTEM-2 NOT RUNNING 

^Step 48: Type CTRL/\. 

Type CTFL/\ to return to the front-end Command Parser. Because the 
system is not running now, you will see the prompt PAR%. If you see 
the prompt PAR> instead, qo back to Step 46. 

PAR% 

^Step 49: Type MCR PIP and Press the RETURN Key. 

To load the PIP program and start it, type MCR PIP and press the 
RETURN key. After 1 second, PIP is ready for you to type commands. 
The system prints the prompt PIP>: 

PAR%MCR PIPQFT) 
PIP> 

^Step 50: Type KL.CFG;*/DE and Press the RETURN Key. 

You must delete any existing front-end configuration file from your 
| front-end file system before bringing up the Version 5.1 front-end 
monitor . 



PIP>KL. CFG ; */DE(jtEL 
PIP> 



NOTE 

If the system prints PIP — NO SUCH 
FILE(S), then you did not have a 
front-end configuration file in your 
front-end file system. Proceed with 
Step 51. 
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^Step 51: Type CTRL/Z and CTRL/\. 



To end PIP and return to the front-end Command Parser, type CTRL/Z 
followed by CTRL/V 



PIP> Z 



PAR% 



^Step 52: Mount Version 5.1 System Floppy A in Floppy Drive and 1 
Version 5.1 System Floppy B in Floppy Drive 1. 1 

^Step 53: Set the Switch Register to 000007 (Switches 0, 1, and 2 Up), 
and Press the ENABLE and SWITCH-REGISTER Buttons 
Simultaneously. 

To bring up the Version 5.1 front-end file system, press the ENABLE | 
and SWITCH-REGISTER buttons simultaneously. The system prints: 

RSX-20F VB14-45E 6:11 5-MAR-82 | 



[SY0 
[DX0 
[DX1 



REDIRECTED TO DX0: ] 

MOUNTED] 

MOUNTED] 



KLI — Version VB12-27 RUNNING 

KLI — KL10 S/N:2102., MODEL B, 60 HERTZ 

KLI — KL10 HARDWARE ENVIRONMENT: 

MOS MASTER OSCILLATOR 

EXTENDED ADDRESSING 

INTERNAL CHANNELS 

CACHE 
KLI — ENTER DIALOG [NO, YES , EXIT, BOOT] ? 
KLI> 

^Step 54: Type NO and Press the RETURN Key. 

To tell the front-end monitor that you want it to take default answers 
to dialog questions, type NO and press the RETURN key. The front end 
prints messages as the system is reloaded, and the bootstrap program 
gives the BOOT> prompt. 

KLI — ENTER DIALOG [NO, YES , EXIT, BOOT] ? 

KLI>NO ( «eQ 

KLI — MICROCODE Version 275 LOADED 

KLI — % NO FILE - ALL MEMORY BEING CONFIGURED 

LOGICAL MEMORY CONFIGURATION. 
ADDRESS SIZE INT TYPE CONTROLLER 
00400000 768K 4 MF20 11 

KLI — % NO FILE - LOADING BOOTSTRAP 
KLI — CONFIGURATION FILE ALTERED 
KLI -- BOOTSTRAP LOADED AND STARTED 

BOOT V10.0 (151) 
[BOOT: LOADING RESIDENT MONITOR] [OK] 

BOOT> 
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^Step 55: Press the RETURN Key. 

To tell the bootstrap program to restart the system, press the RETURN 
key. The system prints [PS MOUNTED] and System restarting, 
wait... before prompting for the date and time. 

BOOT> QiD 

[PS MOUNTED] 

[BOOT: LOADING SWAPPABLE MONITOR, PASS 1] [OK] 

System restarting, wait... 

ENTER CURRENT DATE AND TIME: 

^Step 56: Type the Date and Time, Then Press the RETURN Key. 

After the prompt, type the date and time in the format day-month-year 
hhmm. Then press the RETURN key. 

ENTER CURRENT DATE AND TIME: 5-MAR-82 1112 Clip 

The system prints 

YOU HAVE ENTERED WEDNESDAY, 5-MARCH-82 11:12AM, IS THIS CORRECT 
(Y,N) 

^Step 57: Type Y or N and Press the RETURN Key. 

If you have entered the correct date and time, type Y and press the 
RETURN key. Otherwise, type N and press the RETURN key. The system 
will ask for the date and time again. 

IS THIS CORRECT (Y,N) Y G1D 

The system prints 

WHY RELOAD? 

^Step 58: Type SCH and Press the RETURN Key. 
WHY RELOAD? SCHfSp 
The system prints 

<SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED 
RUN CHECKD? 

NOTE 

The system prints the message SYSTEM 
ACCOUNTS TABLE.BIN NOT FOUND - ACCOUNT 
VALIDATION IS DISABLED because the 
ACTGEN program has not been run. (Refer 
to Chapter 6 of the TOPS-20 System 
Manager's Guide for more information. ) 
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^Step 59: Type N and Press the RETURN Key. 



The CHECKD program examines the entire disk file system, reports any 
errors, and tries to correct the errors. You do not have to run the 
program unless the system crashes unexpectedly or you suspect that 
there may be disk errors. Type N and press the RETURN key. The 
system runs the DDMP program. The DUMP program is a background task 
that moves pages from the disk swapping area to the disk file system. 



RUN CHECKD? N 
RUNNING DDMP 



SYSJOB 5(10) STARTED AT 5-MAR-82 1112 
RUN SYS: ORION 
RUN SYS: QUASAR 



5-MAR- 


82 11:12:09 - TGHA V2(6) IS RUNNING FOR THE FIRST 


***** 






RUN 


SYS : MOUNTR 




RUN 


SYS: INFO 




RUN 


SYS:MAILER 




RUN 


SYS:MAPPER 




RUN 


SYS:LPTSPL 




RUN 


SYS:CDRIVE 




RUN 


SYS: SPRINT 




JOB 





/LOG OPERATOR XX OPERATOR 




ENA 








~ESET 


LOGIN PSEUDO 




"ESET 


LOGIN CONSOLE 




~ESET 


OPERATOR 




PTYCOK 


1 




GET 

/ 
JOB 


SYSTEM :PTYCON.ATO 




1 


/LOG OPERATOR XX OPERATOR 




ENA 








RUN 

/ 

SJ 


SYS:BATCON 




0: 






SJ 


0: 


10/24-INSTALLATION-TEST SYSTEM, 


TOPS-20 MONITOR 


SJ 


1: 






SJ 


1: 


10/24-INSTALLATION-TEST SYSTEM, 


TOPS-20 MONITOR 


SJ 


0: 


@LOG OPERATOR OPERATOR 




SJ 


1: 


@LOG OPERATOR OPERATOR 




SJ 


0: 


JOB 1 ON TTY206 24-OCT-81 11:12 


:22 


SJ 


0: 


@ENA 




SJ 


0: 


$'ESET LOGIN PSEUDO 




SJ 


0: 


$"ESET LOGIN CONSOLE 




SJ 


0: 


$~ESET OPERATOR 




SJ 


0: 


$PTYCON 




SJ 


1: 


JOB 2 ON TTY207 24-OCT-81 11:12 


:23 


SJ 


1: 


@ENA 




SJ 


0: 


PTYCOIO GET SYSTEM :PTYCON.ATO 




SJ 


0: 


PTYCON> SILENCE 




SJ 


1: 


$RUN SYS:BATCON 




[From 


OPERATOR on line 210: SYSTEM IN OPERATION] 


SJ 


0: 


PTYCON.LOG.l 




SJ 


0: 


PTYCON> W ALL 




SJ 


0: 


OPR(0) 3 OPERATOR 


OPR TI 


SJ 


0: 


PTYCON> CONN OPR 




SJ 


0: 


: [CONNECTED TO SUBJOB OPR ( ) ] 





TIME. 



5.1 (5050) 
5.1 (5050) 



0:0:1 
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A. 1.5 Running the CNVDSK Program 

If you did not use the TOPS-20 Tape Archiving feature prior to this 

time, but are planning on using the Tape Archiving feature you must 

run the CNVDSK program to enlarge the file descriptor block of each 

i file that is not open. The Version 5.1 files have already been 
formatted for the Tape Archiving feature. 

^Step 60 Type a CTRL/C at Another Terminal and Log In as OPERATOR. 

Installation-test System, TOPS-20 Monitor 5.1(5050) 

"J ^ ' i 



@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) account QtT) 
Job 1 on TTY205 2-SEP-81 11:05:50 

^Step 61: ENABLE Your Capabilities. 

i 

@ENABr,E (CAPABILITIES) (~"' T ~) 
$ 

^Step 62: Run the CNVDSK Program. 

i 

$PUN (PROGRAM) CNVDSK . EXE QTT) 
Output errors to file: 

^Step 63: Type the Name of Any New File. (ERRORS.LOG Is Only an 
Example. ) 

Output errors to file: ERRORS . LOG QfD 

Convert files: 

^Step 64: Press the ESCAPE Key. The System Prints DSK*: <*>*.*.*. 
Then Press the RETURN Key. The System Prints a List of 
Directories. 

I 

Convert files: DSK* :<*>*.*.* (j<rr) 
PS : <ROOT-DIRECTORY> 
PS:<ACCOUNTS> 
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^Step 65: Use the COPY Command to Print the Log File that You 
Specified in Step 63. 

The CNVDSK program produces a log file containing a list of files 
and/or directories it was unable to convert. It will fail to convert 
a file if the file is open when you run CNVDSK, or if the directory in 
which the file resides is more than three-quarters full (a directory 
can contain a maximum of approximately 300 files) . Use the COPY 
command to print the log file on PLTPO:, or give the TYPE command to 
print the log file on the console terminal. The example below uses 
the COPY command. 

CMD CUD 

J i 

$COPY (FROM) ERPORS.LOG (TO) PLPTO: QeD 

ERRORS.LOG => PLPTO: ERRORS [OKI 
$ 

^Step 66: Examine the Line Printer Listing of ERRORS.LOG. 

Examine the listing of the error file produced by the CNVDSK program 
for files it was unable to convert. Normally, several files of type 
.EXE from directory PS :<NEW-SUBSYS> are shown. This is expected 
because these EXE. files represent programs that were started during 
the system start-up procedures of Step 48. Other files from system 
directories may also be shown for similar reasons. You should save 
this listing. The TOPS-20 System Manager's Guide gives instructions 
for converting any files shown by the listing. 



A. 2 REVERTING TO VERSION 5.0 I 

If you must revert, to running the TOPS-20 Version 5 software, follow | 
the steps in this section. If you want the UETP files when you revert 
to Version 5, you must restore the UETP files from either the Version 
5 Installation Tape or the latest backup tape. I 

^Step 1: Log In to the System with OPERATOR or WHEEL Capabilities. 



@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) accountQTT) 
<? 

^Step 2: Give the Command: ENABLE (CAPABILITIES) and Press the RETURN 
Key. 

To perform the next step you must enable your capabilities. Type 
ENABLE and press the ESC key. The system prints (CAPABILITIES). 
Press the RETURN key. 

( LSC ) 

@ENABLE (CAPABILITIES) GED 

$ 
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^Step 3: Give the Command: RENAME (EXISTING FILES) 
PS:<SYSTEM>5-MONITR.EXE (TO BE) PS : <SYSTEM>MONITR. EXE and 
Press the RETURN Key. 

In Section A. 1.1, you renamed the Version 5 monitor to 
PS:<SYSTEM>5-MONITR.EXE. If you are reverting to Version 5, you must 
put this monitor back into PS : <SYSTEM>MONITR.EXE. Type RENAME and 
press the ESC key. The system prints (EXISTING FILE) . Type 
PS:<SYSTEM>5-MONITR.EXE and press the ESC key. The system prints the 
generation number and (TO BE). Type PS : <SYSTEM>MONITR.EXE and press 
the RETURN key. When the rename has been successfully executed, the 
system prints a message specifying that the file has been renamed 
correctly. 

( "C ) C Eg ) 

\ J 

$RENAME (EXISTING FILE) PS : <SYSTEM>5-MONITR. EXE (TO BE) 

PS:<SYSTEM>MONITR.EXE QjT) 
<SYSTEM>5-MONITR.EXE.l=> <SYSTEM>MONITR. EXE [OK] 

NOTE 

Before reverting to Version 5, examine 
the PS:<SYSTEM>5-C0NFIG.CMD file. Be 
sure it contains a definition of logical 
name SYSTEM:, and that this definition 
does not include the directory, 
PS:<NEW-SYSTEM>. If it does include the 
directory, PS :<NEW-SYSTEM>, when you 
revert to Version 5 the Version 5 
monitor attempts to operate programs 
that do not function properly in a 
Version 5 system. If the 
PS:<SYSTEM>5-CONFIG.CMD file does not 
contain a definition of logical name 
SYSTEM:, insert the following command 
into the file: 

DEFINE SYSTEM: PS:<SYSTEM> 

I^Step 3A: Give the Command: DELETE PS:<SPOOL> 

I PRIMARY-MASTER-QUEUE-FILE. QUASAR and Press the RETURN key. 

Before reverting to the old GALAXY system, you must delete the master 

spooling file. Type DELETE PS :<SPOOL>PRIMARY- and press the ESCAPE 

key. The system prints MASTER-QUEUE-FILE.QUASAR. 1 and gives a message 
verifying the deletion. 

\ 

SDELETE PS :<SPOOL>PRIMARY -MASTER-QUEUE-FILE. QUASARQjD 

PS :<SPOOL>PRIMARY-MASTER-QUEUE-FILE. QUASAR. 1 [OK] 

$ 
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►Step 4: Give the Command: "ECEASE (TIMESHARING AT) Date and Time 
(RESUMING AT) Date and Time and Press the RETURN Key. 

To bring the system down, type CTRL/E CEASE and press the ESC key. 
The system prints (TIMESHARING AT). Type the date and time and press 
the ESC key. The system prints (RESUMING AT). Type the date and time 
you want timesharing to start again and press the RETURN key. The 
system prints a list of messages; the last message is Shutdown 
complete. 



$~ECEASE (TIMESHARING AT) date and time (RESUMING AT) date and timeCjsJ 
Shutdown complete 

^Step 5: Type CTRL/\. 

At the console terminal, type CTRL/\ to return to the front-end 
Command Parser. When you are at Command Parser command level, the 
system prints the prompt PAR>. 

(iiKi.; ) 
PAR> 

^Step 6: Type SHUTDOWN and Press the RETURN Key. 

To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key. 
The system prints a list of messages. 

PAR>S HUTDOWN CUD 
** HALTED ** 

%DECSYSTEM-20 NOT RUNNING 

^Step 7: Reload the Version 5 Monitor Using the Version 5 Floppies or i 
the Version 5 Disk. I 

To reload the Version 5 monitor using the Version 5 floppies, mount | 
System Floppy A in floppy drive 0, press the ENABLE and FLOPPY buttons 
simultaneously, and answer the usual start-up questions. 

To reload the Version 5 monitor using the Version 5 disk, press the f 
ENABLE and DISK buttons simultaneously, and answer the usual start-up 
questions . 

NOTE 

You can reload the Version 5 monitor I 

from disk only if the Version 5 
front-end software is still on the disk. 
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| A. 3 MAKING THE VERSION 5.1 MONITOR THE PRIMARY MONITOR 

| In case you are presently using the Version 5 monitor, you must rename 
it in Step 4, below, before copying the Version 5.1 monitor into 
<SYSTEM>MONITR.EXE. 

^Step 1: Log in to the System with OPERATOR or WHEEL Capabilities. 

r~isc~) ( >« ) (~~tsi"~) 

"I I I 

@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) account C^Q 
@ 

^Step 2: Give the Command: ENABLE (CAPABILITIES) and Press the RETURN 
Key. 

To perform the next few steps you must enable your capabilities. Type 
ENABLE and press the ESC key. The system prints (CAPABILITIES). 
Press the RETURN key. 

( FSC ) 

TENABLE (CAPABILITIES) CeD 
$ 

^Step 3: STOP. 

Proceed with Step 4 if you have reverted to a Version 5 system, and 
your present monitor is a Version 5 monitor. You must rename this 
monitor in Step 4 in case you ever need to revert to Version 5 again. 

| Skip to Step 6 if your present monitor is a Version 5.1 monitor. You 
do not need to rename your present monitor in Step 4. This action was 
already performed in Section A. 1.1, Step 37. 

^Step 4: Give the Command: RENAME (EXISTING FILE) 
| PS:<SYSTEM>MONITR.EXE (TO BE) PS : <SYSTEM>5-MONITR.EXE and 

Press the RETURN Key. 

| To rename and save the Version 5 monitor, type RENAME and press the 
ESC key. The system prints (EXISTING FILE). Type 
PS:<SYSTEM>MONITR.EXE and press the ESC key. The system prints (TO 

| BE). Type PS:<SYSTEM>5-MONITR.EXE. When the Version 5 monitor is 
successfully renamed, the system prints a message specifying that the 
file has been renamed correctly. Continue with Step 5. 



I \ 

$RENAME (EXISTING FILE) PS : <SYSTEM>MONITR . EXE (TO BE) 

| PS:<SYSTEM>5-MONITR.EXEQ^) 

| <SYSTEM>MONITR.EXE.l => <SYSTEM>5-M0NITR. EXE . 1 [OK] 

$ 
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^Step 5: Give the Command: COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE (TO) 
PS:<SYSTEM> MONITR.EXE and Press the RETURN Key. 

To copy the Version 5.1 monitor into PS:<SYSTEM>, type COPY and press 
the ESC key. The system prints (FROM). Type PS : <NEW-SYSTEM> 
montyp.EXE and press the ESC key. (Montyp designates the type of 
monitor you have selected for your system.) The system prints (TO). 
Type PS:<SYSTEM>MONITR.EXE and press the RETURN key. When the copy is 
successfully completed, the system prints a message specifying that 
the file was copied correctly. 



I 1 

$COPY (FROM) PS:<NEW-SYSTEM>montyp.EXE (TO) PS : <SYSTEM>MONITR. EXE f^T) 
<NEW-SYSTEM>montyp.EXE. => <SYSTEM>MONITR. EXE . 1 [OK] 

^Step 6: Give the Command: 'ECEASE (TIMESHARING AT) Date and Time 
(RESUMING AT) Date and Time and Press the RETURN key. 

Shut down the system by typing CTPL/E CEASE and pressing the ESC key. 
The system prints (TIMESHARING AT) . Type the date and time you want 
timesharing to cease and press the ESC key. The system prints 
(RESUMING AT). Type the date and time you want timesharing to start 
again and press the RETURN key. 



\ \ \ 

$ ECEASE (TIMESHARING AT) date and time (RESUMING AT) 
date and time C^Q 

^Step 7: Put the Version 5.1 Front-End Software on Disk. I 

Start at Step 112 of this manual to put the Version 5.1 front-end | 
software on disk. 



NOTE 

When the Version 5.1 front-end software 
is put on disk, the Version 5 front end 
is destroyed. In order to use the 
Version 5 front-end software again, you 
must reinstall it using the Version 5 
floppies. 



@LOGIN (USER) OPERATOR (PASSWORD) password (ACCOUNT) accountQli 
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The steps in this section should be performed when you feel 
comfortable with the Version 5.1 software. | 

^Step 1: Log In to the System with OPERATOR or WHEEL Capabilities. 
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^Step 2: Give the Command: ENABLE (CAPABILITIES) and Press the RETURN 
Key. 

To perform the next step you must enable your capabilities. Type 
ENABLE and press the ESC key. The system prints (CAPABILITIES) . 
Press the RETURN key. 

J 

OENABLE (CAPABILITIES) QED 

^Step 3: Give the Command: COPY (FROM) PS:<NEW-SYSTEM>*.* (TO) 
PS:<SYSTEM>*.* and Press the RETURN Key. 

To copy the directory <NEW-SYSTEM> to <SYSTEM>, type COPY and press 
the ESC key. The system prints (FROM). Type PS : <NEW-SYSTEM>*.* and 

I press the ESC key. The system prints (TO). Type PS:<SYSTEM> and 
press the ESC key. The system prints *.*. Press the RETURN key. The 
system prints a message specifying that each file has been copied 
correctly. 



I GED GE3 

| $COPY (FROM) PS:<NEW-SYSTEM>*.* (TO) PS:<SYSTE * ■ * (~^~) 

^Step 4: Give the Command: COPY (FROM) PS:<NEW-SUBSYS>*.* (TO) 
PS:<SUBSYS> and Press the RETURN Key. 

To copy the directory <NEW-SUBSYS> to <SUBSYS>, type COPY and press 
the ESC key. The system prints (FROM). Type PS :<NEW-SUBSYS>*. * and 
press the ESC key. The system prints (TO). Type PS:<SUB and press 
the ESC key. The system prints SYS>*.*. Press the RETURN key. The 
system prints a message specifying that each file has been copied 
correctly. 



1 I 

$COPY (FROM) PS:<NEW-SUBSYS>*.* (TO) PS : <SUBSYS>* . * CH 



^Step 5: Give the Command: CONNECT (TO DIRECTORY) PS:<SYSTEM> and 
Press the RETURN Key. 

Connect to the directory PS:<SYSTEM> by typing CONNECT and pressing 
the ESC key. The system prints (TO DIRECTORY). Type PS:<SYSTEM> and 
press the RETURN key. 

\ 

$CONNECT (TO DIRECTORY) PS : <SYSTEM> C^D 
$ 
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^Step 6: Give the Command: EDIT (FILE) PS:<SYSTEM>5-l-CONFIG.CMD and | 
Press the RETURN Key. 



To edit the 5-1-CONFIG.CMD file, type EDIT and press the ESC key. The 
system prints (FILE). Type PS : <SYSTEM>5-l-CONFIG. CMD and press the 
RETURN key. 



^Step 8: Give the EDIT Command: R Line Number and Press the RETURN 
Key. 

The parameter DEFINE SYS: PS : <NEW-SUBSYS> , PS:<SUBSYS> must be 
replaced by DEFINE SYSTEM: PS:<SYSTEM>. To do this, type an R and the 
line number where DEFINE SYS: PS : <NEW-SUBSYS> , PS:<SUBSYS> is located; 
then press the RETURN key. The system prints the line number you 
entered in the R command. In the example below, the parameter is 
located at line 00500. 

*R500C^D 

The system prints 

00500 

^Step 9: Type DEFINE SYSTEM: PS:<SYSTEM> and Press the RETURN Key. 

To define SYSTEM: as PS:<SYSTEM>, type DEFINE SYSTEM: PS:<SYSTEM> and 
press the RETURN key. Also, be sure to use the EDIT program's D 
command to delete any line giving another definition of SYSTEM:. 

00500 DEFINE SYSTEM: PS : <SYSTEM> GeD 
The system prints 

1 LINES (00500/1) DELETED 
* 

^Step 10: Type EU and Press the RETURN Key. 

To end the EDIT program and save the file, type EU and press the 
RETURN key. The system prints <SYSTEM>5-l-CONFIG. CMD . 2 and the 
TOPS-20 command prompt. 



*EUC^D 

<SYSTEM> 5-1 -CONFIG. CMD. 2 
$ 
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GID 

1 , 

$EDIT (FILE) PS :<SYSTEM>5-l-CONFIG. CMD GED | 

The system prints: 

EDIT: 5-1-CONFIG.CMD 1 

* 

^Step 7: Give the EDIT Command: P*:* and Press the RETURN Key. 

To print the entire 5-1-CONFIG.CMD file, type P":* and press the 
RETURN key. 
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^Step 11: Give the Command: CONNECT and Press the RETURN Key. 

Connect back to your log-in directory by typing CONNECT and pressing 
the RETURN key. 

$CONNECT QTT) 

$ 

^Step 12: Give the Command: DELETE (FILES) PS: <NEW-SYSTEM>* . *.* and 
Press the RETURN Key. 

To delete the files in the directory PS : <NEW-SYSTEM> , type DELETE and 
press the ESC key. The system prints (FILES). Type 
PS : <NEW-SYSTEM>*.* .* and press the RETURN key. The system prints an 
fOK] message for each file it deletes. 






$DELETE (FILES) PS : <NEW-SYSTEM> * . * . * (j«D 



^Step 13: Give the Command: DELETE (FILES) PS:<NEW-SUBSYS>*.*.* and 
Press the RETURN Key. 

To delete the files in the directory PS :<NEW-SUBSYS> , type DELETE and 
press the ESC key. The system prints (FILES). Type 
PS:<NEW-SUBSYS>*.* .* and press the RETURN key. The system prints an 
[OK] message for each file it deletes. 



$DELETE (FILES) PS : <NEW-SUBSYS> * . * . * 
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^Step 14: Give the Command: "ECEASE (TIMESHARING AT) Date and Time 
(RESUMING AT) Date and Time and Press the RETURN Key. 

Shut down the system by typing CTRL/E CEASE and press the ESCAPE key. 
The system prints (TIMESHARING AT). Type the date and time you want 
timesharing to cease and press the ESCAPE key. The system prints 
(RESUMING AT). Type the date and time you want timesharing to start 
again and press the RETURN key. The system prints a list of messages. 
The last message is Shutdown complete. 



(JE!LJ) C™~ ) 

I I i 

$"ECEASE (TIMESHARING AT) date and time (RESUMING AT) 

date and t imei' ret ) 



Shutdown complete 

^Step 15: Type CTRL A- 

At the console terminal, type CTRL/\ to return to the front-end 
Command Parser. When you are at Command Parser command level, the 
system prints the prompt PAR>. 

Shutdown complete 

(ojnr) 

PAR> 

^Step 16: Type SHUTDOWN and Press the RETURN Key. 

To stop the TOPS-20 monitor, type SHUTDOWN and press the RETURN key. 
The system prints a list of messages. 

PAR>SHUTDOWNC!iD 
** HALTED ** 

%DECSYSTEM-20 NOT RUNNING 

^Step 17: Press the ENABLE and DISK Buttons Simultaneously. 

To run the Version 5.1 software from disk, press the ENABLE and DISK | 
buttons simultaneously and answer the usual start-up questions. 
(Refer to Section A. 1.4, Step 56, of this appendix.) 

NOTE 

If you ever need to revert to Version 5, I 

you must reinstall Version 5, using the I 

Version 5 floppies and tapes. I 

NOTE 

If you are installing any unbundled I 

software, perform the steps specified in I 

the appropriate installation guide that | 

accompanies each optional software 
product. 

^Step 18: Perform the Steps specified in the installation guide that I 
accompanies each optional software product. | 
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POCKET INSTALLATION GUIDE FOR THE DECSYSTEM-20 

This appendix contains an example of a typical installation of the 
TOPS-20 software on a DECSYSTEM-20 Model 2060. 

STEP OPERATION 

1 Read listing labeled TOPS-20. BWP. . 

2 Have the disk packs formatted if necessary. 

3 Power up the system. 

4 Label the disk packs. 

5 Mount the disk packs. 

6 Check the Controller Select switches. 

7 Mount System Floppy A in drive 0. 

8 Mount System Floppy B in drive 1. 

9 Mount the TOPS-20 Software Installation tape on MTAO:. 

10 Place the front-end HALT switch in the ENABLE position. 

11 Set the Switch Register to 000007 (octal). 

12 Press the ENABLE and SWITCH REGISTER buttons simultaneously. 

RSX-20F VB14-45 11:21 9-FEB-82 

ISY0: REDIRECTED TO DX0:] 

[DX0: MOUNTED] 

[DX1: MOUNTED] 

KLI — VERSION VB12-27 RUNNING 

KLI — ENTER DIALOG [NO, YES, EXIT, BOOT]? 

13 KLI>YES[RET) 

KLI — KL10 S/N: 2123., MODEL B, 60 HERTZ 
KLI — KL10 HARDWARE ENVIRONMENT: 

MOS MASTER OSCILLATOR 

EXTENDED ADDRESSING 

INTERNAL CHANNELS 

CACHE 

KLI -- RELOAD MICROCODE [YES, VERIFY, FIX, NO]? 

14 KLI>YFSigET' 

KLI -- MICROCODE VERSION 274 LOADED 

KLI — RECONFIGURE CACHE [FILE, ALL, YES, NO]? 
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16 KLI>ALLIReB 

KLI -- ALL CACHES ENABLED 

KLI — CONFIGURE KL MEMOPY [FILE, ALL, REVERSE, FORCE, YES, NO]? 

17 KLI > ALL lip 

LOGICAL MEMORY COFIGURATION : 

ADDRESS SIZE INT TYPE CONTROLLER 
00000000 256K 4 MB20 0&1 
01000000 768K 4 MF20 10 
04000000 768K 4 MF20 11 

18 KLI — LOAD KL BOOTSTRAP [FILE, YES, NO, FILENAME]? 
KLI>MTBOOT rprr) 

KLI — WRITE CONFIGURATION FILE [YES, NO]? 

19 KLI>NC(H) 

BOOT V10.0 (151) 

20 MTBOOT>/L (ret; 

[BOOT: STARTING CHN:1 DX20X:0 MICROCODE V7(0)] [OK] (DX20 ONLY) 
[BOOT: LOADING RESIDENT MONITOR] [OK] 

21 MTBOOT>/G143(REt) 

[FOR ADDITIONAL INFORMATION TYPE "P" TO ANY OF THE FOLLOWING QUESTIONS.] 

22 DO YOU WANT TO REPLACE THE FILE SYSTEM ON THE SYSTEM STRUCTURE? YES (RlD 

23 DO YOU WANT TO DEFINE THE SYSTEM STRUCTURE? YES WD 

24 HOW MANY PACKS ARE IN THIS STRUCTURE? I irTTi 

26 ON WHICH "CHANNEL, CONTROLLER, UNIT" IS LOGICAL PACK #0 MOUNTED? , - 1 , (D 

28 DO YOU WANT THE DEFAULT SWAPPING SPACE? YESiREfl 

31 DO YOU WANT THE DEFAULT SIZE FRONT END FILE SYSTEM? YES (Set) 

33 DO YOU WANT THE DEFAULT SIZE BOOTSTRAP AREA? YES [SET) 

34 WHAT IS THE NAME OF THIS STRUCTURE? PS : (SET 

[STRUCTURE "PS" SUCCESSFULLY DEFINED] 

[PS MOUNTED] 

[BOOT: LOADING SWAPPABLE MONITOR, PASS 1] [OK] 

%%NO SETSPD 

System restarting wait . . . 

36 ENTER CURRENT DATE AND TIME: 9-FEB-82 11: 30AM (REi) 

YOU HAVE ENTERED TUESDAY, 9-FEBRUARY-1982 11:30AM, 

37 IS THIS CORRECT (Y,N) Y '.flfn 

38 WHY RELOAD? NEW (REJ1 

<SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT VALIDATION IS DISABLED 
RUNNING DDMP 



39 



NO SYSJOB 



[CTRL C 

NO EXEC 
40 MX>c;ET FILE MTA0 : (RET] 

INTERRUPT AT 
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41 MX>GET FILE MTAO : <nl 

4 2 MX>START f Sfl 

TOPS-20 Command processor 5(710) 

43 @FNABLE (CAPABILITIES ) 'wi: 

;esc; 

44 $RUN (PROGRAM) MTAO : (M 

iE">a 

45 DLUSER>LOAD (FROM FILE) MTAO : ffiHi 
DONE. 

[f;a 

46 DLUSER>EXTT (TO MONITOR)"" 

(ESQ 

I 

47 SPUN (PROGRAM) MTAO : (RFH 

US!'! 

1 

48 DUMPEP>TAPE (DEVICE) MTA0:i«sn 

ItSC'l (ESC) (ESC] 

I 

49 DUMPER>FERTORE (TAPE FILESJPS :<*>*.*. * (TO) PS : <SYSTEM> * . * . * )<e;i 

DUMPER TAPE #1, "SYSTEM FILES FOR TOPS-20 V5" , TUESDAY, 9-FEB-82 1147 
LOADING FILE(S) INTO PS:<SYSTEM> 

END OF SAVESET 

ifSCj (ESC) (ESC! 

r i i 

50 DUMPEFORESTORE (TAPE FILES) PS: <*>*.*.* (TO) PS : SUB SYS> * . * . * ra v 

DUMPER TAPE #1, "SUBSYS FILES FOR TOPS-20 V5", TUESDAY, 9-FEB-82 1151 
LOADING FILE(S) INTO PS:<SUBSYS> 

END OF SAVESET 

(ESC! (ESC) (ESC) 

i J I 

5.1 DUMPER>PESTORE (TAPE FILES) PS: <*>*.*.* (TO) PS : <UETP. L [ B>* . * . * i'»Ti 

DUMPER TAPE #1, "UETP FILES FOR TOPS-20 V5" TUESDAY 9-FEB-82 1159 
LOADING FILES INTO PS : <UETP . LIB> 

END OF SAVESET 

(Eg) (ESC) (flO 

1 1 1 

52 DUMPER>RESTORE (TAPE FILES) PS: <*>*.*.* (TO) PS : <SUB SYS> * . * . * liu'f! 

DUMPER TAPE #1, "GALAXY V4 . SUBSYS FILES FOR TOPS-20 V5" TUESDAY 9-FEB-82 1204 
LOADING FILE(S) INTO PS:<SUBSYS> 
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FND OF SAVESET 



NOTE 



If you have an RP20 disk subsystem, 
perform Steps 53 through 55. Otherwise, 
continue the installation procedures at 
Step 56. 

53 DUMPEP>UNLOAD -rari 
DUMPEP> 

54 Mount RP20 Microcode Tape on MTAO : . 

[fia (ESC! (ESC) 

1' . I 

55 DUMPER>RESTOFE (TAPE FTLES) PS:<*>*.*.* (TO) PS : <SUBSYS> *.*.* ffl 

DUMPER TAPE ft 1 , "PP20 DX20 MICROCODE FOR TOPS-20 V5" TUESDAY 9-FEB-82 1210 
LOADING FILE(S) INTO PS:<SUBSYS> 

END OF SAVESET 

56 DUMPER>EXIT [FifD 

(esc) 

57 SUNLOAD (DEVICE) MTAO : iip 

'.ESll (ESQ 

58 $INFORMATION (ABOUT) DISK-USAGE (OF DIRECTORY) PS:<*>f(ff) 



tSJ? 

59 SRUN (PROGRAM) PS : <SUBS YS>MAKDMP . EXE ifliT) 

i E SCI i'ESC) 

60 MAKDMP>CPEATE (DUMP FILE) PS : <SYSTEM>DUMP . EXE (MEMORY SIZE) 
memory size Iftlt] 

61 MAKDMP>EXIT(ReT 

(EF.C1 

r 

6 2 SCONNECT (TO DIRECTORY) PS : <SYSTEM> STD 

ESCI (ESS) 

i I 

63 $COPY (FROM) 2060-MONBIG.EXE (TO) MONITR . EXE (ret) 
2060-MONBIG.EXE.l => MONITR . EXE . 1 ; P7 77700 [OK] 



B-4 



POCKET INSTALLATION GUIDE FOR THE DECSYSTEM-20 



64 $TERMINAL (MODE IS) NO RAISE® 

(KB Hg 

i i 

65 $COPY (FROM) TTY: (TO) MONNAM . TXT ® 
TTY: => MONNAM.TXT. 1 
Installation-test System® 

itiBpn 

i ~ 

"Z 

(§sc! JsJ 

i i 

66 SCOPY (FROM) TTY: (TO) TAPNAM . TXT ® 
TTY: => TAPNAM.TXT. 1 

Instal-tst ® 

! 

"Z 

© 
1 

67 SCREATE (FILE) 5-CONFIG . CMD ® 
INPUT: 4-CONFTG.CMD 

68 00100 ! Terminal Speeds!® 

00200 ! Line 1 has input=9600 and output = 9600® 

00300 TERMINAL 1 SPEED 96001® 

00400 ! Lines 2 to 20 have input and output = 2400® 

00500 TERMINAL 2-20 SPEED 2400® 

00600 ! Lines 22 to 40 are shut off® 

00700 TERMINAL 22-40 SPEED 0® 

00800 ! Line 21 is a dialup line® 

69 00900 TERMINAL 21 REMOTE SPEED 300® 
01000 TERMINAL 22 REMOTE AUTO® 

70 01100 DEFINE NEW: PS : <NEW> , SYS : ® 
01200 DEFINE OLD: PS : <OLD> , SYS : ® 
01300 DEFINE HLP: SYS:® 

01350 DEFINE SERR: PS : <SYSTEM-ERROR> ® 

72 01400 MAGTAPE 24 ® 
01500 MAGTAPE 1 25® 

73 01600 PRINTER VFU SYS : NORMAL . VFU ®' 
01700 PRINTER 1 VFU SYS :NORMAL . VFU ® 

74 01800 PRINTER LOWERCASE RAM SYS : LP9 6 . RAM ® 
01900 PRINTER 1 RAM S YS : LP6 4 . RAM ® 

75 02000 TIMEZONE 5® 

78 02100 ENABLE FULL-LATENCY-OPTIMIZATION® (see CAUTION, below) 

79 02200 ENABLE WORKING-SET-PRELOADING ®i 

80 02300 BIAS 6® 

81 02400 CREATE .15® 
02500 CREATE 1 . 20 ® 
02600 CREATE 2 .40® 

82 02700 BATCH-CLASS 3® 
2800 CREATE 3 .25® 

83 02900 ENABLE CLASS-SCHEDULING ACCOUNTS ALLOCATED® 

84 03000 ARCHIVE-TAPE-RECYCLE-PERIOD 1825® 

85 03100 TAPE-RECYCLE-PERIOD 90® 

86 03200 ENABLE TAPE-DRIVE -ALLOCATION ® 

87 03300 TAPE-RECOGNITION-ERRORS UNLOAD® 

88 03400 CHANGE WEEKDAYS 9:00® 
03500 CHANGE WEEKDAYS 17:00® 
03600 CHANGE SATURDAY 0:00® 
03700 ma 

89 *EU® 



B-5 



POCKET INSTALLATION GUIDE FOR THE DECSYSTEM-20 



CAUTION -- Stop 86 

Before you can use this performance feature, you 
must obtain from your Digital Field Service 
Representative the following information about your 
hardware. 

1. If you have a KL10-C processor, it must be at 
revision level 11. 

2. If you have a KL10-E processor, it must be at 
revision level 3. 

3. If you have board M7772, it must be at revision 
level E and CS revision level F; or you may 
have board M7786. 

If your hardware does not meet the above 
requirements, take the system default, which is, 
DISABLE FULL- LATENCY-OPTIMIZATION. 



91 $"EOREATE (DIRECTORY NAME) PS : -'OPERATOK> fiETl 

92 SSPASSWORD TH INK-SUN (mil 

93 $$USER-GROUP (NUMBER) ItlOiRFi 

94 SSIPCF (CABABILITY) mf 

9 5 SS r:i 

« 'I [ ■■ LSI.' 

96 $~ECREATE (DIRECTORY NAME) PS : ^REMARKS > :RFT! 

9 7 $$Ri- 

98 $CONNECT (TO DIRECTORY) 'SUBSYS> 'RET) 

99 SCREATE (FILE) LPFORM . INI (RET' 

00100 NORMAL/BANNER : 2/HEADER : 2/TRA I LER: 2 Mil 

200 NARROW/BANNER: 2/HEADER: 2/TRA I LER : 2 /WIDTH: 7 2 (RET) 

00300 fici 

100 *EU HETi 

[LPFORM.INI] 
$ 



NOTE 

If you are part of the ARPA network, perform the 
steps in APPENDIX E at this time. 
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NOTE 

Perform Steps 101 through 111 only if you are using 
an RP07 disk pack for your system structure. 

101 SRUN (PROGRAM) CHECKOUT] 

■:sc: 
i 

102 CHECKD>CREATE (NEW FILE SYSTEM FOR) FE-FYS:(SFfl 

103 ENTER ALIAS: FE-SYS : hei) 

104 HOW MANY UNITS IN THIS STRUCTURE: 1 wfl 

105 CHANNEL, CONTROLLER, AND UNIT NUMBER FOR LOGICAL UNIT 0: 1, -1, (RET) 

106 NUMBER OF PAGES TO ALLOCATE FOR SWAPPING? 7 3 5 (Set) 

107 NUMBER OF PAGES TO ALLOCATE FOR THE FRONT-END FILE SYSTEM? 950'?'H! 

108 OWNER NAME? OPERATOR IBEfi 

109 IS THIS A SYSTEM STRUCTURE FOR STARTUP? YES (fieri 

110 SERIAL NUMBER OF CPU STARTED FROM THIS STRUCTURE? 2 1 2 iFitil 

111 CHECKD>EXTT(ni:n 

113 P«l." i 
1 1 4 PAR>SIIUTDOWN (ml; 
** HALTED ** 

%DECSYSTEM-20 NOT RUNNING 

115 Set the switch register to 000003 (OCTAL) . 

116 Hold ENABLE .snd press the SWITCH REGISTER button. 
RSX-20F VB14-45 6:11 9-FEB-82 





[SY0: REDIRECTED TO D 




IDX0: MOUNTED] 




[DX1: MOUNTED] 


117 


(CTRL' ] 


119 


PAR%MCR INI (RET) 


120 


INI>DB0: m 


121 


OR! . 'i 


122 


PAR%MCR MOUfp 


123 


MOU>DB0: (ret) 




MOU — MOUNT COMPLETE 




tMTZ~} 


124 


MOU>~Z 




(CTRL/J 


125 


PAR%MCR UFDffitTi 
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126 UF'D>DB0: [ 5 , 5 I !«U) (Proceed to next step after 10 seconds.) 

127 cm "i 

128 PAR%VCF PIP ! m 

129 P1P>DB0: /NV=DX0: *. * ,DXl : * . * luEJi 

130 pi:p>"z 

131 PAR%MCR REDiRiJ) 

132 RED>DB0 :=SY0 :(fTet) (Proceed to next step after 5 seconds.) 

133 iCTFl i 

134 PAR%MCR SAV (ret) 

135 Set Switch Register to 

136 SAV>SY0:/WBlRE!) 
[DBO: DISMOUNTED] 
[DXO: DISMOUNTED! 
[DX1: DISMOUNTED] 

137 Store the floppy disks in a safe place. 

138 Mount System Floppy C on Drive 0. 

1 3 9 (C" ! : ' 

140 PAR^MCR MOU (BE! 

141 MOU>QX0:;REfi 

MOU — MOUNT COMPLETE 

142 MOU'Z 

c : i 

143 PAR*MCR PIP TOll 

144 PTP>DR0:/NV=DX0:*.* »i,i 
1 45 P [P>DB0 : /LI (bet) 
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DIRECTORY DBO: [5,5] 
9-NOV-81 1 L: 25 



F11ACP.TSK; 


;1 


77. 


C 


09-FEB-82 


11: 


;19 


TKTN.TSK;! 




6. 


C 


09-FEB-82 


11: 


; 20 


MOU.TSK;l 




5. 


c 


09-FEB-82 


11 : 


: 20 


KLX.MCB;1 




53. 




09-FEB-82 


11: 


:20 


BOOT.EXB; 1 




41. 




09-FEB-82 


11: 


:20 


MTBOOT.EXB; 


: 1 


40. 




09-FEB-82 


11: 


:21 


BF16N1 .All; 


:1 


1. 




09-FEB-82 


11: 


:21 


PARSER.CMD; 


:1 


10. 




09-FEB-82 


11 : 


:21 


PARSER. TSK; 


:1 


71. 


c 


09-FEB-82 


11: 


:22 


KLDISC.TSK; 


:1 


5. 


c 


09-FEB-82 


11; 


:22 


KLRING.TSK; 


:1 


6. 


c 


09-FEB-82 


11: 


:22 


LOGXFR.TSK; 


:1 


10. 


c 


09-FEB-82 


11: 


:22 


MIDNIT.TSK; 


;1 


4. 


c 


09-FEB-82 


11: 


:22 


SETSPD.TSK; 


:1 


5. 


c 


09-FEB-82 


11: 


:23 


KLI.TSK;! 




72. 


c 


09-FEB-82 


11: 


:23 


T20ACP.TSK ; 


:1 


8. 


c 


09-FEB-82 


11: 


:23 


BOO. TSK ;1 




19. 


c 


09-FEB-82 


11: 


:23 


COP. TSK ;1 




8. 


c 


09-FEB-82 


11: 


:23 


DMO.TSK;l 




5. 


c 


09-FEB-82 


11: 


:24 


INI.TSK;! 




23. 


c 


09-FEB-82 


11: 


:24 


PIP.TSK;1 




56. 


c 


09-FEB-82 


11: 


:24 


RED. TSK ;1 




6. 


c 


09-FEB-82 


11: 


:24 


SAV.TSK;1 




23. 


c 


09-FEB-82 


11: 


:25 


UFD.TSK;! 




9. 


c 


09-FEB-82 


11: 


:25 


ZAP.TSK;1 




38. 


c 


09-FEB-82 


11: 


:25 


RSX20F.SYS; 


1 


58. 


c 


09-FEB-82 


11: 


:25 


RSX20F.MAP; 


:1 


150. 




09 -NOV- 81 


11: 


:25 



TOTAL OF 809. BLOCKS IN 27. FILES 





an ~!Q 


146 


PIP>"Z 




tiwy~) 


147 


PAR%MCR DMO (B 


148 


DMO>DX0: (U 




pR[""z"l 


149 


DMO>"Z 




fijicm 




PAR% 



150 



Be sure the central processor is stopped. 
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151 Hold ENABLE and press the DISK button. 

RSX-20F VB14-45 6:11 9-FEB-82 

[3Y0: REDIRECTED TO DB0:1 
[DBO: MOUNTED] 

KLI — VERSION VB12-27 RUNNING 
KLI -- KL10 S/N: 2123, MODEL B, 60 HERTZ 
KLI — KL10 HARDWARE ENVIRONMENT 

MOS MASTER OSCILLATOR 

EXTENDED ADDRESSING 

INTERNAL CHANNELS 

CACHE 

KLI -- MICROCODE VERSION 274 LOADED 
KLI -- ALL CACHES ENABLED 

LOGICAL MEMORY CONFIGURATION 

ADDRESS SIZE INT TYPE CONTROLLER 
00000000 256K 4 MB20 0&1 
01000000 768K 4 MF20 10 
04000000 768K 4 MF20 11 

KLI -- CONFIGURATION FILE ALTERED 
KLI -- BOOTSTRAP LOADED AND STARTED 

BOOT V10.0(151) 

[BOOT: STARTING CHN: 1DX2X:A MICROCODE V7(0)] [OK] DX20 ONLY 

[BOOT: LOADING RESIDENT MONITOR] [OK] 

[PS MOUNTED] 

[BOOT: LOADING SWAPPABLF MONITOR, PASS 1] [OK] 

System restarting wait . . . 

152 ENTER CURRENT DATE AND TIME: 9-FEB-82 13 «Ei' 

YOU HAVE ENTERED TUESDAY, 9-FEBRUARY- 1 982 1:00PM, 

153 IS THIS CORRECT (Y,N) Y f ; r 
1 54 WHY RELOAD? r C -I ■ 

<SYSTEM>ACCOUNTS-TABLE.BIN NOT FOUND - ACCOUNT 
VALIDATION IS DISABLED 
1 55 RUN CHECKDPN ,: .n 

RUNNING DDMP 

SYSJOB 5(10) STARTED AT 9-FEB-82 1112 
RUN SYS:ORION 
RUN SYS: QUASAR 

***** 

9-FEB-82 11:12:09 - TGHA V2 IS RUNNING FOR THE FIRST TIME. 
***** 

RUN SYS:MOUNTR 

RUN SYS: INFO 

RUN SYS: MAILER 

RUN SYS: MAPPER 

RUN SYS:LPTSPL 

RUN SYS:CDRIVE 

RUN SYS:SPRINT 

JOB /LOG OPERATOR XX OPERATOR 

ENA 

"ESET LOGIN PSEUDO 

"ESET LOGIN CONSOLE 

"ESET OPERATOR 



B-10 



POCKET INSTALLATION GUIDE FOR THE DECSYSTEM-20 



PTYCON 

GET SYSTEM: PTYCON. ATO 

/ 

JOB 1 /LOG OPERATOR XX OPERATOR 

ENA 

RUN SYS:BATCON 

/ 

0: 

10/24-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 5(3117) 

10/24-INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 5(3117) 
@LOG OPERATOR OPERATOR 
?LOG OPERATOR OPERATOR 

JOB 1 ON TTY206 9-FEB-82 11:12:22 
@ENA 

$"ESET LOGIN PSEUDO 
$"ESET LOGIN CONSOLE 
$~ESET OPERATOR 
$ PTYCON 

JOB 2 ON TTY207 9-FEB-82 11:12:23 
@ENA 

PTYCON> GET SYSTEM : PTYCON . ATO 
PTYCON> SILENCE 
$RUN SYS:BATCON 

From OPERATOR on line 210: SYSTEM IN OPERATION] 
PTYCON.LOG. 1 
PTYCON> W ALL 

OPR(0) 3 OPERATOR OPR TI 0:0:1 

PTYCON> CONN OPR 
[CONNECTED TO SUBJOB OPR(O)] 



SJ 





SJ 





SJ 


1 


SJ 


1 


SJ 





SJ 


1 


SJ 





SJ 





SJ 





SJ 





SJ 





SJ 





SJ 


1 


SJ 


1 


SJ 





SJ 





SJ 


1 


[From 


SJ 





SJ 





SJ 





SJ 





SJ 






156 e.irl o j 

Installation-test System, TOPS-20 Monitor 5(710) 

157 @SYSTAT OPERATOR (rail 



DET 

1 206 

2 207 

3 210 



SYSJOB 
PTYCON 
BATCON 
OPR 



OPERATOR 
OPERATOR 
OPERATOR 

OPERATOR 



158 
159 



(fSCl lEC! 

T i 

@ATTACH (USER) OPERATOR (JOB #) 1 »f 
[PSEUDO-TERMINAL, CONFIRM] irk- 
PASSWORD: your password hi in 
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160 



161 

162 



OPR>SKOW STATUS TAPE-DRIVE /ALL (RE? 
OPR> 
9:35:49 — Tape Drive Status-- 

DRIVE STATE VOLID REQ# JOB* USER 



MTAO: Unloaded 

AVR: Yes 
MTA1 : In Use DEK 31 

AVR: Yes, Write: Yes: 
MTA2: Loaded 

AVR: Yes, Write: Ye:: 
MTA3: Unloaded 

AVR: Yes 
MTA4: Unloaded 

AVR : No 
MTA5: Unloaded 

AVR: Yes 
OPR>SET TAPE-DRIVE MTAO: UNAVA I LABLE !RF~T) 
INSTALLING OPTIONAL SOFTWARE (bet! 
::tu _' 



45 LARRUP 
Unlabeled 



Unlabeled 



163 



OPR>PUSH!fiET) 



164 



165 
166 



9ASSIGN (DEVICE) MTAO : SlB 

tig! 

TENABLE (CAPABILITIES) inr. 
SDUMPER IREfl 



167 

1 68 
169 

170 



171 



DUMPER>TAPE (DEVICE) MTAO:® 

Mount the optional or update software tape. 

DUMPER>REWIND lip) 

<tSC) (IS§ 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <OPERATOR>(H 

DUMPER TAPE # 1, <DOCUMENTS>, TUESDAY, 9-FEB-82 17:41 
LOADING FILE(S) INTO PS : <OPERATOR> 

END OF SAVESET 

'fSCi (ESC) 

DUMPER>RESTORE (TAPE FILES) PS: <*>*.*.* (TO) PS : <SUBSYS>(gn) 

DUMPER TAPE # 1, <BINARY>, TUESDAY, 9-FEB-82 17:45 
LOADING FILE(S) INTO PS:<SUBSYS> 

END OF SAVESET 
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173 Dismount the tape and store it in a safe place. 

174 Go back to S':ep 168 if you want to restore other software products. 

175 DUMPER>EXIT(Rfn 

;i:si: 
1 

176 $DEASSTGN (DEVICE) MTA0:inrf' 

NOTE 

Tf you performed Steps 156 through 176, you may now 
skip to Step 1 81 . 

178 icrm c ! 

Installation-test System, TOPS-20 Monitor 5(3117) 

PO its:) (reel 

1 I T 

179 @LOGIN (USER; OPERATOR (PASSWORD) password (ACCOUNT) OPERATOR (REii 

rsi: 
I 

180 ^ENABLE (CAPABILITIES) ran 

i si; 

181 Stake (commands from) <uftp. lieoset-up.cmd (REii 

ilr,r:i 
i 

182 $CONNECT (TO DIRECTORY) <UETP. RUN> Wf> 

ffifl 

183 $RUN (PROGRAM) UETP . EXE (RFr; 

[9-FEB-82 10:42:41 User Environment Test Package] 

!!SQ 
i 

184 UETP>TAKE (COMMANDS FROM) <UETP . LIB>VERI FY . CMD (ntfi 
UETP>ENABLE VERIFY/CYCLE : 1 (RF'i 

10:38:07 [ENABLE COMPLETED] 
UETP>BEGINfCT 

10:42:07 [BEGIN COMPLETED] 
UETP>DEFAULT/CYCLE : 00 : 30 (j«5 

10:43:01 [DEFAULT COMPLETED] 
UETP>ENABLE RANCBLfRFl! 

10:43:07 [ENABLE COMPLETED] 
UETP>ENABLE RANFORfRrT) 

10:43:07 [ENABLE COMPLETED] 
UETP>ENABLE MTAOCfiEj) 

10:43:07 [ENABLE COMPLETED] 
UETP>STATUS!RFD 



B-13 



POCKET INSTALLATION GUIDE FOR THE DECSYSTEM-20 



| 9-FEB-82 9:42:47] 

Test Depth Status Cycle Times Error Error Start 



name 



run count limit time 



Queued 


1 











Enabled 


0:15 











Enabled 


0:15 











Enabled 


0:15 












VERIFY VER Queued 1 dd-mmm-yy hh:mm: ss 

RANCBL VEP 

RANFOR VER 

MTA0 VER 

IJETP> 

155 Mount a scratch tape on MTA0:, 

UETP>ENABL,E MTA0<set; 

186 UETP>BEC INHEi, 

The following steps are optional. Perform only the steps 
that pertain to your system. 



188 UETP>ENABLE (TEST) BASIC'I"; 
10:45:08 [ENABLE COMPLETED] 



189 UETP>ENABLE (TEST) ALGOLS 
10:45:08 [ENABLE COMPLETED] 



190 UETP>ENABLE (TEST) DBMS :"K.i 

10:45:08 fENABLE COMPLETED] 



191 UETP>ENABLE (TEST) APL(nf': 

10:45:08 [ENABLE COMPLETED] 



192 UETP>BEGTN (UETP RUN AFTER) n< 
10:45:09 [BEGIN COMPLETED] 



NOTE 

Do not perform the following steps until all the 
tests are completed. 



193 UETP>EXlT!RFt; 
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i si) 

T 

194 Stake (commands from) ps:<uetp.lib>clean-up.cmd(ret) 

[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD] 
[OLD1 
[OLD] 
End of <UETP. LIBXTLEAN-UP.CMD. 3 

19 5 $ POP RET) 

OPR> 



196 Start timesharing. 
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Perform the steps in this appendix only if you are using the ARPA 
network . 

At this point you have installed the ARPANET software. 

W^ Step 1: Give the Command: CONNECT (TO DIRECTORY) PS : <SYSTEM> and 
Press the RETURN Key. 

If you are part of the ARPA network, you must add a parameter to the 
PS:<SYSTEM>5-CONFIG.CMD file. Type CONNECT and press the ESC key. 
The system prints; (TO DIRECTORY). Type PS : <SYSTEM> and press the 
RETURN key. 

f 
$CONNECT (TO DIRECTORY) PS : <SYSTEM> @ 

$ 

W^ Step 2: Give the Command: EDIT (FILE) 5-CONFIG.CMD and Press the 
RETURN Key. 

If you are using the ARPA network you must set up a HOST number in the 
5-CONFIG.CMD file. Type EDIT and press the ESC key. The system 
prints (FILE). Type 5-CONFIG.CMD and press the RETURN key. 



?EDIT (FILE) 5-CONFIG.CMD© 



C.l DEFINING THE HOST NUMBER 

You should have received a HOST number from ARPA when you were given 
permission to connect to the ARPANET. If you do not know your HOST 
number, you can get it by phoning the ARPANET Network Control Center 
at BB&N. The format for the HOST command is: 

HOST octal-host-number 
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t^ Step 3: Give the Edit Command: I Line Number. Press the RETURN Key. 

To insert the HOST command into the 5-CONFIG.CMD file, type I and then 
the number of the line at which you want to insert the HOST command. 

* I 2 1 5 (15 
* 

W^ Step 4: Type the HOST Number. 

Type HOST followed by the OCTAL-HOST-NUMBER and press the RETURN key. 

2150 HOST 4 5 
* 

W^ Step 5: Type EU and Press the RETURN Key. 

Type EU and press the RETURN key to save the file without line 
numbers. The system prints the file specification and the $ prompt. 

*euEIT) 

[5-CONFIG.CMD.l] 
$ 



C.l.l Entering the Host Number, Name, and Other Pertinent Information 

The following information must be entered into a file named 
HSTNAM.TXT: 

1. Host number 

2. Host name 

3. System type 

4. Flags 

5. NEW 

The format for the command is: NNN,SSSS ,TT,F1 , . . . ,Fn 

Where: 

NNN is the host number in octal. 

SSSSS is the name string. 

TT is the system type spelled out. (A null string means no 
system type or insufficient representation.) Current valid 
types are: 
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TENEX -- Systems running somo version of BEN-Tenox or 

TOPS-20. 

ITS — System running a version of ITS. 

DEC — System running DECsystem-10. 

TIP — a TIP. 

MTIP — Magtape TIP. 

ANTS — some ANTS. 

ELF — ELF operating system for PDP-11. 

MULTICS — MULTICS 



Fl,...,Fn are flags, as follows: 

USER — Doesn't run Server TELNET. 

SERVER — Runs some type of Server TELNET on Sockets 1 

and/or 27(8) . 
nickname -- This is another name you can give for the 

host. 



NEW 



-- Uses new network protocol (RAR/RAS, etc) 



NOTE 

The following section shows you how to 
edit the file HSTNAM.TXT to include 
information that pertains to your own 
system. A version of HSTNAM.TXT is 
included with every new DECSYSTEM-20. 
However, to be sure of using the most 
up-to-date version, you should use the 
FTP program to copy the 
file, <SYSTEM>HOST-NAME/DESCRIPTOR-FILE. 
TXT from node SRI-KA of the ARPANET 
network. Copy this file into the file 
PS:<SYSTEM>HSTNAM.TXT. Then proceed 
with Step 6 below. 



^ Step 6: 



Give the Command: 
RETURN Key. 



EDIT (FILE) HSTNAM.TXT and Press the 



You must enter your Host Number, Host Name, and other pertinent 
information into the file HSTNAM.TXT. Type EDIT and press the ESC 
key. The system prints (FILE) . Type HSTNAM.TXT and press the RETURN 
key. The system prints the name of the file being edited, the 
generation number, and the EDIT prompt. 



$EDIT (FILE) HSTNAM.TXT (H) 
EDIT: HSTNAM.TXT. 1 



W^ Step 7: 



Give 
Key. 



the EDIT Command: 



I Line Number and Press the RETURN 



To inform the EDIT program where to 
then the line number you have 
Press the RETURN key. The system p 
following is an example: 

*I 150(H) 
00150 



The 



> insert the information, type I and 
chosen to place the information in. 
>rints the line number you entered. 
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^ Step 8: Type the Information for Your Syst 



em. 



Type the information for your system. The following is just an 
example. You must enter the information pertaining to your system. 



0150 14 5, DEC-MARLBORO, TENEX, SERVER, USER, NEW (RED 
* 



NOTE 

The previous example assumes that the 
line number you selected was between two 
existing line numbers. If the line 
number you selected was at the end of 
the file, the system will print another 
line number. If the latter is the case, 
press the ESC key and continue at the 
next step. 

t^ Step 9: Type EU and Press the RETURN Key. 

To end the EDIT program and save the file without line numbers, type 
EU and press the RETURN key. The system prints the name of the file 
and the TOPS-20 enabled prompt. 

*EU(S3 

[HSTNAM.TXT. 2] 
$ 

NOTE 

Proceed at Chapter 4 (Creating the 
Front-end File System) . 



C-4 



APPENDIX D 
GENERATING A TAILORED BATCH AND SPOOLING SYSTEM 



D . 1 INTRODUCTION 

This appendix shows you how to generate a TOPS-20 batch and spooling 
(GALAXY) system specifically tailored for your installation. To do 
this you must have already installed a standard Release 4.2 GALAXY 
system. The standard GALAXY system is satisfactory for most sites. 
The procedures shown in Chapters 1 through 7 of this manual, or in 
Appendix A or B, show you how to install Release 5.1 TOPS-20 software, 
including a standard Release 4.2 GALAXY system. After performing 
those procedures, you can use the steps in this appendix if you need 
to generate a GALAXY system having different parameters from the 
standard one. 

NOTE 

While the steps in generating a tailored 
Release 4.2 GALAXY system can be used 
with timesharing users logged in, the 
critical phase of stopping the standard 
Release 4.2 system and starting up your 
tailored one (Steps 29-56) should, for 
safety reasons, be performed on a 
stand-alone system. The queues need not 
be empty, however, as long as a Release 
4.2 (as opposed to Release 4.0 or 
earlier) GALAXY system is already 
running. 

The following paragraphs summarize the procedure for generating and 
starting up a new GALAXY system. The actual steps you would perform 
are shown in the next section. 

1. Run the DUMPER program to transfer the GALAXY source files 
from the TOPS-20 bundled system software tape (also called 
the TOPS-20 Distribution Tape) to a disk directory. This 
directory is referred to as the build area. In addition to 
the source code, this directory contains a special batch 
control file called GALAXY. CTL. 

2. Run the GALGEN program to create a file containing the new 
GALAXY system parameters. The name of the parameter file is 
GALCNF.MAC. 
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3. Submit the control file GALAXY. CTL to your currently running 
batch system. The batch job that is created by GALAXY. CTL 
reads the parameter file created by GALGEN and generates a 
new set of GALAXY files of type .EXE in a temporary area. 
The batch job creates a log file that should be saved for 
reference, at least until the new GALAXY system is correctly 
operating . 

4. Stop all the components of the currently running GALAXY 
system (QUASAR, LPTSPL, etc.). 

5. Copy all old GALAXY files from their current area (usually 
SYS:) to some other area. 

6. Copy all new GALAXY files from the temporary area to SYS:. 

7. Start up the components of the new batch system. 

8. When you are sure that the new batch system is operating 
correctly, you can delete the .EXE files of the old system. 
If you want to be cautious, you can save the old .EXE files 
on tape. You can also delete the GALAXY source files (and 
the unrelated files restored along with them from the 
Distribution Tape) from the build area. However, if your 
installation can spare the disk space, it is more convenient 
to leave the sources on disk. Then, if any code patches must 
be made to the batch system, you have the sources readily 
available. Otherwise, you have to restore the sources from 
the software tape if patching is required. 

NOTE 

The procedures described below assume that you have a 
Release 4.2 GALAXY system currently running. These 
procedures can be carried out during normal 
t lmeshar ing . 



D.2 RESTORING THE GALAXY FILES 



NOTE 

These procedures assume that you are 
using the console terminal (CTY) and are 
attached to the system PTYCON job. 

^>Step 1: Give the Command: WHAT ALL and Press the RETURN Key. 

To find out which PTYCON subjob is running the OPR program, give the 
PTYCON command WHAT ALL and press the RETURN key. The system responds 
with a list of PTYCON subjobs, followed by the PTYCON> prompt. 

PTYCON>WHAT ALL fi^T) 
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^Step 2: Give the Command: CONNECT (TO SUBJOB) and Press the RETURN 
Key. 

To connect to the subjob running the OPP proqram, type CONNECT and 
press the ESC key. The system prints (TO SUBJOB). Type OPR and press 
the RETURN key. The system prints the OPR prompt. 

( ESC ) 

PTYCON>CONNECT (TO SUBJOB) OPRGiD 
OPR> 

^Step 3: Give the Command: SHOW STATUS TAPE-DRIVE /ALL and Press the 
RETURN Key. 

To find out which tape drives are not in use, give the SHOW STATUS 
TAPE-DRIVE /ALL command, and press the RETURN key. The systerr 
responds with a list of tape drives and their status. 

OPR>SHOW STATUS TAPE-DRIVE /ALLGeD 

^Step 4: Give the Command: SET TAPE-DRIVE MTAO: UNAVAILABLE and 
Press the RETURN Key. 

To allow the use of a tape drive without the intervention of the 
MOUNTR program, give the command SET TAPE-DRIVE, and insert the number 
of a tape drive that is not presently in use (MTAO: is only an 
example) . Type UNAVAILABLE and press the RETURN key. The system 
prints, Enter Text and Terminate with ~Z. 

OPR>SET TAPE-DRIVE MTAO: UNAVAILABLE (W) 

Enter Text and Terminate with ~Z 

Error: If you see an error message similar to ?Tape drive 
allocation is not enabled, your site does not have tape 
drive allocation enabled. Therefore, you do not have to 
set any drives unavailable. Skip to Step 6. 

^Step 5: Type USING GALGEN PROCEDURE ~Z. 

To give a reason for setting a tape drive unavailable, enter USING 
GALGEN PROCEDURE and type a CTRL/Z . The system prints ~Z and gives 
the OPR> prompt. 

Enter Text and Terminate with ~Z 

Q IKi /) 

J 

USING GALGEN PROCEDURE "Z 

OPR> 
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I^Step 6: Type PUSH and Press the RETURN key. 

Type PUSH to move to another level and press; the RETURN key. 
OPR>PUSH(j<lD 



||^Step 7: Type ASSIGN MTAO : and Press the RETURN Key. 

Assign to your job the tape drive that you set unavailable in Step 4. 
^ASSIGN MTAO: Q1D 



NOTE 

The examples in this manual show MTAO: 
as the tape drive used to restore files 
from the Distribution Tape. However, 
you can assign and use any tape drive. 
Be sure to use the name of the tape 
drive you assign in this step whenever 
MTAO: appears in this appendix. 



|^Step 8: Type ENABLE and Press the RETURN Key. 

@enableCkD 



I^Step 9: Give the Command: "ECREATE (DIRECTORY NAME) 
Press the RETURN Key. 



PS:<BUILD> and 



Create a directory to hold the GALAXY source files. Although you can 
give it any name, a reasonable name for this directory is PS:<BUILD>, 
because it is also known as the build area. Type CTRL/E CREATE and 
press the ESC key. The system prints (DIRECTORY NAME) . Type 
PS:<BUILD> and press the RETURN key. The system prints [NEW] and the 
subcommand prompt ($$) . 

(Tikl/i ) ( fcSl ~ ) 

T \ 

Recreate (directory name) ps : <build>QeD 

[NEW] 

$$ 



K 



Step 10: Give the Subcommands: 
Press the RETURN Key. 



WORKING 3000 and PERMANENT 3000 and 



Assign sufficient storage space to the directory to allow copying of 
the entire fourth save set (not just the GALAXY sources). Then 
complete the command with a final carriage return. 



$$working 3 00 0q[d 
$$permanent 3000qil 
$$qft) 
$ 
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^Step 11: Mount the Distribution Tape on MTAO:. 

To restore the GALAXY files from tape, mount the Distribution Tape 
(the TOPS-20 bundled system software tape) on the tape drive you 
assigned in Step 7. If you need help, refer to Chapter 2, Section 
2.1.1, Step 9, of this manual. 

^Step 12: Type DUMPER and Press the RETURN Key. 

You need the DUMPER program to restore the GALAXY source files from 
tape. Type DUMPER and press the RETURN key. The system prints the 
DUMPER> prompt. 



$dumperCmi 

DUMPER> 



^Step 13: 



Give the 
Key. 



Command: TAPE (DEVICE) MTAO: and Press the RETURN 



To tell the DUMPER program the tape drive you are using, type TAPE and 
press the ESC key. The system prints (DEVICE). Type the name of the 
tape drive on which you mounted the Distribution tape in Step 16 
(MTAO: is only an example). Press the RETURN key. The system prints 
the DUMPER> prompt. 

( KSf ]) 
1 

DUMPER>TAPE (DEVICE) MTAO : G<ED 
DUMPER> 

^Step 14: Give the Command: SKIP 3 and Press the RETURN Key. 

To skip over the first three save sets on the Distribution Tape, give 
the command SKIP 3 and press the RETURN key. The DUMPER program 
prints a message identifying each save set it skips, and then gives 
the DUMPER> prompt. Be prepared for a 5- to 10- minute wait while 
DUMPER positions the tape. 

DUMPER>SKIP ;s f^Q 

DUMPER> 
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Step 15: Give the Command: RESTORE (TAPE FILES) PS :<*>*.*.* (TO) 
PS:<BUILD>*.*.* and Press the RETURN Key. 

To restore all the files from the fourth save set (including the 
GALAXY source files) , type RESTORE and press the ESC key. The system 
prints (TAPE FILES). Type PS: and press ESC. The system prints 
<*>*.*.* (TO). Type PS:<BUILD> and press ESC. The system prints 
*.*.*. Press the RETURN key. The system prints a message identifying 
the tape and then the message, Loading file(s) into PS:<BUILD>. Be 
prepared for a wait of approximately 10 minutes between this message 
and the next DUMPER> prompt. " ~ 

Cl_0 (JED C EST ) 

f I I 

DUMPER>RRSTORE (TAPE FILES) PS :<*>*.*. * (TO) PS : <BUILD> * . * . * f^D 

Error: If DUMPER does not print a message identifying the save set 
as "Language Sources for TOPS-20 V5.1", the tape is not 
positioned at the correct save set. Give the REWIND command 
to DUMPER and begin again at Step 14. 

Error: If the message, Loading files into PS:<BUILD>, does not 
appear, no files are being restored from tape. Be sure that 
the correct tape is mounted on the tape drive you have 
assigned to your job. Then begin again at Step 9. If 
errors persist, the tape may be bad. Contact your DIGITAL 
Field Service Representative for assistance. 



^Step 16: Give the DUMPER Commands: REWIND and EXIT. 



Once the fourth save set has been restored from tape, rewind the tape 
and exit from DUMPER. Give the DUMPER command REWIND, and press the 
RETURN key. The DUMPER program prints the DUMPER> prompt. Give the 
DUMPER command EXIT. The DUMPER program finishes, and the system 
prints the TOPS-20 enabled prompt ($). 

DUMPER>REWINDQkT) 
DUMPER>EXIT(^D 



^Step 17: Give the Command: INFORMATION (ABOUT) DISK-USAGE (OF 
DIRECTORY) PS:<BUILD> and Press the RETURN Key. 

To verify that you have restored all the files from the fourth save 
set of the TOPS-20 Distribution Tape, type INFO and press the ESCAPE 
key; the system prints RMATION (ABOUT). Type DIS and press the 
ESCAPE key; the system prints K-USAGE (OF DIRECTORY) . Type 
PS:<BUILD> and press the RETURN key. The system prints information 
about the amount of disk space used by the directory. 

G"£) ChD 

i i 

$INFORMATION (ABOUT) DISK-USAGE (OF DIRECTORY) PS : <BUILD> QfD 

PS:<BUILD> 

2865 Pages assigned 

3000 Working, 3000 Permanent pages allowed 

7971 Pages free on PS: 
$ 
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^Step 18: STOP. 

If the number of pages assigned does not approximately match the 
number shown in this manual, you may not have restored all the files 
necessary for creating a GALAXY system. Check to be sure you have the 
correct tape mounted, then begin again at Step 12. 

^Step 19: Give the Commands: UNLOAD (DEVICE) MTAO: and DEASSIGN 
(DEVICE) MTAO: and Press the RETURN Key. 

Once the GALAXY source files have been restored from the Distribution 
Tape, you should unload the tape and return the tape drive to the pool 
of available resources. Type UNLOAD and press the ESC key; the 
system prints (DEVICE). Type MTAO: (or the name of the tape drive on 
which you mounted the Distribution Tape in Step 11) and press the 
RETURN key. The system prints the TOPS-20 enabled prompt ($). Type 
DEASSIGN and press the ESC key; the system prints (DEVICE). Type 
MTAO: and press the RETURN key. The system prints the TOPS-20 
enabled prompt. 

$UNLOAD (DEVICE) MTAO: C^O 

GiD 

$DEASSIGN (DEVICE) MTAO : QE) 



You can now remove the Distribution Tape from the tape drive. If you 
need help, refer to Chapter 2, Section 2.5, Step 57 of this manual. 

^Step 20: STOP. 

If in Step 4 you set unavailable the tape drive you used, you should 
make it available again to timesharing users: go on to Step 21. 
Otherwise, skip to Step 24. 

^Step 21: Type POP and Press the RETURN Key. 

To return the tape drive to the pool of tape drives under control of 
the MOUNTR program, you must return to the previous level. Type POP 
and press the RETURN key. The system prints the OPR> prompt. 

$POPChD 
OPR> 

^Step 22: Give the Command: SET TAPE-DRIVE MTAO: AVAILABLE and Press 
the RETURN Key. 



OPR>SET TAPE-DRIVE MTAO: AVAILABLE QlD 
OPR> 

^Step 23: Give the Command: PUSH and Press the RETURN Key. 

OPR>PUSH C^Ip 

$ 
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D.3 RUNNING THE GALGEN PROGRAM 

|^Step 24: Type GALGEN and Press the RETURN Key. 

You must run the GALGEN program to create the GALAXY configuration 
I file PS:<BUILD>GALCNF.MAC, which will contain the parameters 
describing the tailored GALAXY system you are building. Type GALGEN 
and press the RETURN key. The GALGEN program responds by giving its 
name and version number, and then printing several paragraphs of 
information. 

$GALGEN GjeT) 
| GALGEN Version 4(2031) 

[Starting GALAXY Generation Procedure for TOPS-20 System] 
[Writing GALAXY Configuration File PS :<BUILD>GALCNF.MAC. 3] 



In the following dialog, all questions are of the for 



m: 



Text of question (List or range of answers) [Default answer] 

The line starts with the actual text of the question. Following 
the question is a description of the possible answers enclosed in 
parentheses. This description might be a range of numbers, a 
list of keywords, or a textual description. Following this 
description is the default answer, enclosed in square brackets. 
The default will be assumed if you only press the RETURN key. 

You have the choice of carrying on a LONG dialog in which an 
explanation of each question is provided automatically, or a 
SHORT dialog in which it is assumed that you are familiar with 
the GALAXY generation procedure. In either case, you can always 
obtain the help text by typing a question mark (?) in response to 
any question. 

Answer the following question either LONG (for a long dialog) or 
SHORT (for a short one) . Simoly pressinq the RETURN key implies 
SHORT. 



Dialog Length (SHORT, LONG) [SHORT] 



|^Step 25: 



STOP. 



You have the option of a long dialog, in 



choices 



which GALGEN 



g, in which GALGEN explains the 

it offers you, or a short one, in which only the choices 

themselves are displayed. If you are an experienced user of GALGEN, 

you may want the short dialog, which is faster; in this case, press 

the RETURN key and skip to Step 35. 

|^Step 26: Type LONG and Press the RETURN key. 

To request the long dialog with GALGEN, type LONG and press the RETURN 
key. GALGEN responds with some information and then the first 
question about GALGEN parameters. 
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^Step 27: Answer the Questions in the GALGEN Display. | 

GALGEN presents a series of questions, one at a time, for you to I 
answer. If you asked for a long dialog in Step 26, an explanation of 
each question is included. Otherwise, you see only the questions, the 
range of choices, and the default answer. The default answer is the 
one that appears in brackets ([]). This value is used if you answer 
the question by pressing the RETURN key. 



Below is a sample of the dialog you would see if you typed LONG in 
Step 26. Press the RETURN key when you want to see the next question 
in the GALGEN dialog. 



I 



NOTE 

You must supply the correct values for 
your own system. 

Administrative Controls and Parameters 

The questions in this section determine absolute GALAXY parameters, 
which cannot be overridden by user or operator controls. 

The system logs all operator interactions in a disk file in the 
spooling area. Your answer to the following question specifies the | 
name to be used for this file. 



Operator log filename (3-20 Characters) [OPERATOR-SYSTEM] | 

I 



Users can specify a priority for their batch and spooling requests 
with the /PRIORITY switch. The allowable values on this parameter 
range between 1 (representing lowest priority) and 63 (representing 
the highest) . The following two questions relate to this switch. The 
first question requests the maximum priority that may be specified by 
a non-privileged user. 

Maximum priority non-privileged users may specify (10-63) [20] | 

You can specify the value to be used if the user does not specify a 
/PRIORITY switch. This value must be between 1 and the maximum that 1 
you specified in the previous question. I 

Default for /PRIORITY on batch and spooling requests (1-63) [10] f 



TOPS-20 Version 5.1 D-9 December 198 2 



I 



GENERATING A TAILORED BATCH AND SPOOLING SYSTEM 

Appl ications 

The following section establishes parameters for applications 
supported by GALAXY (for example, NCP) . These applications will be 
accessible throuqh OPR, the operator interface. 



I 

| Will you be running appl ications? (YES , NO) [YES] 



You can enable applications throuqh your answers to the following 
questions . 



Each application must be associated with an application table name 
(for example, NCPTAB) . 

Application name or carriage return to exit(l-20 characters) 

Batch Job Defaults 

The questions in this section are used to define default values for 
the various options that a user can specify when submitting a batch 
job. 

The batch user can specify a maximum runtime for his batch job using 
the /TIME switch. If he does not specify this switch, the following 
I default will be used: 

Default batch job runtime limit (5-9999 Seconds) [3001 C^T) 



Every batch job has maximum limits for each type of spooled output. 
These limits can be set by the batch user with appropriate switches to 
the SUBMIT command. If the user doesn't specify these switches, the 
following defaults will be used: 

ine printer output limit(0-9999 pages) r 200 ] 
:ard punch output limit(0-9999 cards) [10001 
Paper tape punch output limit(0-5000 feet) [2001 
Plotter output limit(0-5000 minutes) [30] 

The user can specify whether or not the batch log file should be 
printed after the job terminates by using the /OUTPUT switch to the 
SUBMIT command. The action is specified by: LOG to always print the 
log file, NOLOG to never print the log file, and ERROR to print the 
log file only if the job ended with an unhandled error. If the user 
doesn't specify this switch, the following value will be used: 

| Default for batch SUBMIT/OUTPUT (LOG , NOLOG, ERROR) [LOG] 
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L ine Printer Defaults and Parameters 

The questions in this section are used to set default values for the 
line printer spoolers. 

Job banner pages printed at the beginning of each print request. The 
user's name and any /NOTE value is printed on them. 

Number of job banner pages (0-5) [2] 

Job trailer pages are printed at the end of each print request. The 
user's name and any spooler checkpoint information is printed on them. 

Number of job trailer pages(0-5) [2] 

File header pages are printed before each file or copy in each print 
request. The file name is printed in BOLD letters on each header 
page. 

Number of file header pages(0-5) [2] 

The user can specify a special form for a print request with the 
/FORMS switch. If this switch is not specified, the following default 
will be used: 

Name for standard output forms (of 4-6 characters) [NORMAL] 

The number of characters that uniquely identifies a form is compared 
with the current form name to determine if a forms change is required 
for a specific user request. 

Number of characters that uniquely identifies form(2-6) [41 

Tape Label Action 

The system administrator can allow non-privileged users to bypass 
label processing. 

Allow bypassing for non-privileged users? (YES , NO) [NO] 
Mi scellaneous Default s and Parameters 

The questions in this section refer to general GALAXY parameters. 

The following section establishes default bias and 
disk-page-to-spooler unit conversion factors. 

Do you want the standard limit computation (YES, NO) [YES] 

The default action to be taken when output exceeds the specified limit 
for an output spooler may be to ABOPT the job and ignore all remaining 
output, ASK the operator what to do, or PROCEED to finish processing 
the job. 

Default output-limit-exceeded act ion (ABORT, ASK , PROCEED) [ASK] 

ABORT C^T) 



I 



[End of Galgen Dialog] 
$ 
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D.4 ASSEMBLING THE NEW GALAXY SYSTEM 

Step 28: Give the Command: SUBMIT (BATCH JOB) GALAXY. CTL 
/TIME : : 30 : 00/RESTARTABLE . 

In the last step you completed the GALGEN program, which produced the 
GALAXY parameter file, GALCNF.MAC. This file contains your choice of 
options for a tailored batch and spooling system. To create this 
batch and spooling system you must submit the GALAXY control file, 
GALAXY. CTL, to your present batch system. GALAXY. CTL reads GALCNF.MAC 
and generates the files and programs for a tailored GALAXY system. 

Type SUBMIT and press the ESC key; the system prints (BATCH JOB). 

Type GALAXY and press the ESC key; the system prints .CTL.l. Type 

/TIME:0:30:00/RESTAPTABLE and press the RETURN key. The system prints 

a message giving the job name, the request I.D., and the time limit of 
the batch job. 



I 1 

$SUBMIT (BATCH JOB) GALAXY. CTL.l /TIME : : 30 : 00/RESTARTABLE C-FT) 

[Job GALAXY Queued, Request-ID 170, Limit 0:30:00] 
$ 



NOTE 

If assembly is unsuccessful, examine the 
appropriate .LOG file to see if you can 
find the problem. If you can, correct 
it (which might involve editing the 
control file) , delete the .LOG file, and 
resubmit the specified .CTL file. If 
you are unable to determine what caused 
the failure, consult your systems 
programmer or software specialist. 

When the GALAXY system assembly succeeds, you see a series of messages 
similar to the following printed on your terminal: 



| LPTSPL ASSEMBLY SUCCESSFUL 
| CDRIVE ASSEMBLY SUCCESSFUL 



A message is printed for each control file generated. 

The new batch system can now be run. However, before you proceed to 
the next step, it is advisable to check the .LOG files to be sure that 
no problems arose during batch system generation. It is conceivable 
that a %-type (warning) error occurred. Such an error might not cause 
processing of GALAXY. CTL to be unsuccessful, but could create problems 
later when you attempt to use the new batch system. Therefore, it is 
important that you correct any problems now, before you stop running 
the current batch system. 
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D.5 SHUTTING DOWN THE OLD GALAXY SYSTEM 

Once you have checked the .LOG files to be sure that no errors | 
occurred during the build procedure, you are ready to stop all old 
GALAXY programs and start the new ones. | 



NOTE 

During the following steps, Steps 29-56, 
it is important not to have timesharing 
users logged in to the system, as their 
jobs could initiate batch or spooling 
requests during the critical period of 
changeover. However, it is acceptable 
for requests to be present in the queues 
at the time of Step 29 as long as the 
old GALAXY system is a Release 4.2 
system. 



^Step 29: Type POP and Press the RETURN Key. 

To return to the CPR program so you can stop the old GALAXY objects 
type POP and press the RETURN key. The system prints the OPR> prompt. 

$POP Q^T) 
OPR> 

^Step 30: Give the Command: SHOW STATUS and Press the RETURN key. 

To determine which GALAXY objects are in use, give the SHOW STATUS 
command, and press the RETURN key. The system responds with a list of 
GALAXY objects. 



OPR>SHOW STATUS 

0PR> 

13:42:58 

Printer Status: 
Unit Status 

Idle 

Batch-Stream Status: 

Strm Status 

Idle 

1 Idle 

2 Idle 



System Device Status -- 
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^Step 31: Give SHUTDOWN Commands for Each Component of the GALAXY 
System. 

To be sure that each GALAXY object has been shut down, you must give a 
SHUTDOWN command for each GALAXY object shown in Step 30. 

QED ( esc ) 

1 1 

OPR>SKUTDOWN (SCHEDULING FOR) PRINTER (unit number) C^T) 

CMD ( >« ) 

I I 

OPR>SHUTDOWN (SCHEDULING FOR) BATCH-STPEAM (stream number) 0:2® 



Error: If you see a message similar to:--THEPE ARE NO DEVICES 
STARTED--, you can ignore this message and go on to the 
next SHUTDOWN command. The message means only that 
your site was not using the specified device. 

^Step 32: Give the Command: SHOW STATUS and Press the RETURN key. 

To verify that all parts of the GALAXY system have been shut down, 
give the SHOW STATUS command, and press the RETURN key. 



OPR>SHOW STATUS ChD 

OPR> 

13:44:55 

OPR> 



There are no devices started 



^Step 33: Give the Command: EXIT and Press the RETURN Key. 

To return to TOPS-20 command level so you can kill the GALAXY 
components, type PUSH and press the RETURN key. The system prints the 
enabled prompt. 

OPR>EXIT(j<*D 
$ 

^Step 34: Give the Command: "ESPEAK and Press the RETURN Key. 

To kill the GALAXY components you must give the "ESPEAK command. Type 
CTRL/E SPEAK and press the RETURN key. The system prints, [PLEASE 
TYPE SYSJOB COMMANDS - END WITH " Z 1 . 



I 

$ "ESPEAK fST) 

[PLEASE TYPE SYSJOB COMMANDS - END WITH '' Z ] 
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^Step 35: Give the KILL Command for each GALAXY Component. 

You should KILL all the components referenced in SYSJOB.PUN. You 
should also KILL BATCON, which normally runs as a separate job under 
SYS JOB. 

[PLEASE TYPE SYSJOB COMMANDS - END WITH ~Z] 
KILL QUASAR QID 
KILL ORION ChL.) 
KILL MOUNTRChD 



^Step 36: Type CCJOB 1, and Press the RETURN key. 

CCJOB IQe) 



^Step 37: Type STATUS and Press the RETURN Key. 
STATUS C^T) 

^Step 38: Type "Z and Press the RETURN Key. 

To return to TOPS-20 command level, type CTRL/Z . The system prints 
the TOPS-20 enabled prompt. 



1, 

$ 

^Step 39: Give the Command: ~ECREATE (DIRECTORY) PS: <OLD-GALAXY> and 
Press the RETURN Key. 

You should create a directory to store your old GALAXY system before 
copying your new one into SYS:. Type CTRL/E CREATE and press the 
ESCAPE key. The system prints (DIRECTORY). Type PS :<OLD-GALAXY> and 
press the RETURN key. The system prints [NEW] and the enabled 
subcommand prompt. 

(ttrTT) ( ESC ) 

r i 

$ ECREATE (DIRECTORY NAME) PS : <OLD-GALAXY>CHD 

[NEW] 

$$ 

^Step 40: Press the RETURN Key. 

To create a directory with default characteristics, press the RETURN 
key. 

[NEW] 
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^Step 41: Give the Command: COPY (FROM) SYS: QUASAR. EXE (TO) 
PS : <OLD-GALAXY> and Press the RETURN Key. 

To copy your old QUASAR program into the back-up directory that you 
just created, type COPY and press the ESCAPE key. The system prints 
(FROM). Type SYS : QUASAR. EXE and press the ESCAPE key. The system 
prints (TO). Type PS : <OLD-GALAXY> and press the RETURN key. The 
system prints a message verifying that it has copied the file. 

I I 

$COPY (FROM) SYSrQUASAR.EXE (TO) PS : <OLD-GALAXY> C^D 

PS:<SUBSYS>QUASAR.EXE.l => PS : <OLD-GALAXY>QUASAR. EXE . 1 [OK] 
$ 

^Step 42: Copy the other files of Your GALAXY System into 
PS:<OLD-GALAXY>. 

Repeat Step 41 as many times as necessary to copy all the files of 
your present GALAXY system into PS : <OLD-GALAXY>. You must copy all of 
the following files, if they exist. 

QUASAR.EXE 

BATCON.EXE 

CDRIVE.EXE 

GLXLIB.EXE 

SPRINT.EXE 

LPTSPL.EXE 

OPR.EXE 

ORION.EXE 

PLEASE.EXE 

QMANGR.EXE 

SPROUT.EXE 

MOUNTR.EXE 
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D.6 STARTING UP THE NEW GALAXY SYSTEM 

Now you are ready to replace the old GALAXY system on SYS: with your 
new tailored system., 

^Step 43: Give the Command: COPY (FROM) PS:<BUILD>QUASAR.EXE (TO) 
PS:<SUBSYS>QUASAR.EXE and Press the RETURN Key. 

To copy the QUASAR.EXE component of the new GALAXY system into the 
system area, type COPY and press the ESCAPE key. The system prints 
(FROM). Type PS : <BUILD>QUASAR. EXE and press the ESCAPE key. The 
system prints (TO). Type PS :<SUBSYS>QUASAR.EXE and press the RETURN 
key. The system prints a message verifying the file it has copied 
correctly. 

1 I 

$COPY (FROM) PS:<BUILD>QUASAR.EXE (TO) PS : <SUBSYS>QUASAR ■ EXE ("Sip 

PS:<GALAXY>QUASAR.EXE.l => PS : <SUBSYS>QUASAR . EXE . 1 [OK] 



^Step 44: Copy the other components of the GALAXY system into the 
system area. 

Repeat Step 43 as many times as it is necessary to copy all the files 
of your new GALAXY system into PS:<SUBSYS>. You must copy all the 
files listed in Step 42. 

^Step 45: Give the Command: ~ESPEAK and Press the RETURN Key. 

To start the new GALAXY system you must give the "ESPEAK command. 
Type CTRL/E SPEAK and press the RETURN key. The system prints, 
[PLEASE TYPE SYSJOB COMMANDS - END WITH ~Z1 



I 

$"ESPEAK(«D 

[PLEASE TYPE SYSJOB COMMANDS - END WITH ~ Z ] 

^Step 46: Give the RUN Command for each component in the new GALAXY 
system. 

To be sure that all components of the GALAXY system are started, you 
must give the RUN command for each component shown in Step 35. 

[PLEASE TYPE SYSJOB COMMANDS - END WITH ~Z] 



RUN SYSrOUASARC^T 
RUN SYS:ORIONCsD 
RUN SYS :BATCONdlZ 
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^Step 47: Type JOB 1 / and Press the RETURN Key. 

RUN SYS:QUASAR 

RUN SYS:ORION 

RUN SYS:BATCON 



JOB 1 /C^D 

^Step 48: Give the Command: RUN SYS:BATCON and Press the RETURN Key. 

JOB 1 / 

RUN SYS:BATCON(~SQ 

^Step 49: Type / and Press the RETURN Key. 

JOB 1 / 

RUN SYS:BATCON 



/C«d 

^Step 50: Give the Command: STATUS and Type "Z and Press the RETURN 
Key. 

RUN SYS:BATCON 
/ 



1 

STATUS "Z CHT) 
$ 

|^Step 51: Type OPR and Press the RETURN Key. 

| You must return to OPR command level to start the components of your 
new GALAXY system. At TOPS-20 command level, type OPR and press the 
RETURN key. The system prints the OPR prompt. 

$ OPR ("ST) 

OPR> 

^Step 52: Type TAKE SYSTEM: SYSTEM.CMD and Press the RETURN key. 

To start all the components of the new GALAXY system, type TAKE 
SYSTEM:SYSTEM.CMD and press the RETURN key. 



OPR>TAKE SYSTEM: SYSTEM. CMDQSL 
OPR> 
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^Step 53: Give the Command: SHOW STATUS and Press the RETURN key. 

To verify that each component of your GALAXY system is running 
properly, you should now give a SHOW STATUS command and press the 
RETURN key. 

OPR>SHOW STATUS C^D 

^Step 54: Type PUSH and Press the RETURN key. 

To move to another level, type PUSH and press the RETURN key. 
opr>pushG»D 

^Step 55: Type ENABLE and Press the RETURN key. 

@ENABLE (~^P 
$ 



D.7 MAKING YOUR NEW GALAXY SYSTEM THE PERMANENT SYSTEM 

Once your new system is successfully running, you may want to delete 
all the files from PS:<BUILD>, PS:<GALAXY>, and PS : <OLD-GALAXY> to 
make more disk space available. 

^Step 56: Give the Command: DELETE PS : <BUILD>*. * , PS: <OLD-GALAXY>*. * 
and Press; the RETURN Key. 

J 

$DELETE (FILES) PS : <BUILD>* . * , PS : <OLD-GALAXY>* . * CUD 

^Step 57: Type POP and Press the RETURN key. 

To return to OPR level to supervise your new GALAXY system, type POP 
and press the RETURN key. 

$POP C^iD 

OPR> 
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Spooling system, 1-6 

tailoring a, D-l 
Startinq command processor, 

2-21 
Starting GALAXY system, 

D-17 
Starting miniexec, 2-20 
Starting the TOPS-20 

monitor, 2-6, 2-19 
Stopping GALAXY system, 

D-13 
Structure, 

defining the system, 2-14 
naming the, 2-18 
Structure size, 

maximun, 3-3 
Swapping , 

working set, 3-15 
Swapping space, 
default, 2-15 
SWITCH REGISTER, 2-7 
Switches , 

check inq CONTROLLER 
SELECT, 2-4 
SYS:LP64.RAM, 3-12 
SYS:LP96.RAM, 3-12 
SYS:NORMAL.VFU, 3-12 
SYSJOB.RUN file, 5-4 
System, 

batch, 1-6 

creating a TOPS-20 file, 

2-1 
initializing the file, 

2-13 
restarting the, 5-1 
spooling, 1-6 
tailoring a batch, D-l 
tailoring a spooling, D-l 
tailoring an ARPANET, C-l 
tailoring your, 3-1 
System defaults, 

creating, 3-6 
System disk usage, 2-30 
System floppy A, 1-5 
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System floppy B, 1-5 
System floppy C, 1-5 
System name, 

changing, 3-4 

maximum, 3-4 
System parameters, 

changing, A-14 



Tailoring a batch system, 

D-l 
Tailoring a spooling system, 

D-l 
Tailoring an ARPANET system, 

C-l 
Tailoring your system, 3-1 
Tape, 

DX20 microcode, 1-5 
Tape contents, 

installation, 1-5 
Tape drive allocation, 3-18 
Tape label action, D-ll 
Tape recycle period, 3-18 
Tape savesets, 

distribution, 1-5 

installation, 1-5 
Tape verification test, 7-4 
Tapes, 

TOPS-20 distribution, 1-5 
Tapes serial numbers, 

magnetic, 1-4 
TAPNAM.TXT, 3-5 
Terminal lines, 1-3 
Terminal speeds, 

setting, 3-6 
Testing other software, 7-5 
Tf ape, 

TOPS-20 installation, 1-5 
Time, 

entering date and, 5-3 
Timezone, 

defining the, 3-13 
TIMEZONE command, 3-13 
TOPS-20 distribution tapes, 

1-5 
TOPS-20 file system, 

creating a, 2-1 
TOPS-20 installation tfape, 

1-5 
TOPS-20 monitor, 

loading the, 2-6 

starting the, 2-6, 2-19 
TOPS-20 monitors, 1-6, 3-4 



TOPS-20 software, 

restoring, 2-24 

updating, A-l 
TOPS-20 software package, 

checking, 2-1 
TOPS20.BWR file, 1-2, 2-2 
TRAILER command, 3-23 
TU45 tape drive, 

mounting, 2-5 
TU77 tape drive, 

mounting, 2-6 
TU78 tape drive, 

mounting, 2-6 
TV. EXE, 3-9 



UETP, 

running, 7-1 
UETP package, 7-1 
UETP. EXE, 7-2 
UFD program, 4-1 
Unit number, 1-2, 3-10 
Update tape, 

Installing, 6-1 
Updating TOPS-20 software, 

A-l 
User-group, 

changing operator's, 3-21 



Validation, 

account, 3-14 
Verification tests, 7-3 
VERIFY. CMO file, 7-3 
Version 5.1 permanent 
monitor , 

making, A-26 
Version 5.1 primary monitor, 

making, A-25 
Version numbers, 2-8 
VFU command, 3-12 
VFU file, 

specifying a, 3-12 



Working set preloading, 

3-15 
Working set swapping, 3-15 
Writing RSX-20F 

configuration file, 

2-11 
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READER'S COMMENTS 

NOTE: This form is for document comments only. DIGITAL will use comments submitted on 
this form at the company's discretion. If you require a written reply and are eligible to 
receive one under Software Performance Report (SPR) service, submit your com- 
ments on an SPR form. 

Did you find this manual understandable, usable, and well-organized? Please make sugges- 
tions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 



Name Date. 



Organization Telephone . 

Street 



City State Zip Code 



or Country 
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MARLBOROUGH, MA 01752 



Do Not Tear - Fold Here and Tape 



UPDATE NOTICE 

TOPS-20 KL Model B 
Installation Guide 
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December 1982 

Insert this Update Notice in the TOPS-20 KL Model B 
Installation Guide to maintain an up-to-date record of changes 
to the manual. 



Changed Information 

The changed pages contained in this update package reflect 
TOPS-20, Version 5.1 and GALAXY, Version 4.2. 

The instructions for inserting this update start on the next page. 



© Digital Equipment Corporation 1982. All Rights Reserved. 
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The following list of page numbers specifies which pages are to be placed in the TOPS-20 KL Model B 
Installation Guide as replacements for, or additions to, current pages. 



r Title page 
■-Copyright page 



rA-1 

La 



29 



rill 

L v 



rD-1 

Ld-1< 



r3-1 
^3-27 



-lndex-1 
-lndex-6 



KEEP THIS UPDATE NOTICE IN YOUR MANUAL TO MAINTAIN AN UP-TO-DATE 
RECORD OF CHANGES. 

TYPE AND IDENTIFICATION OF DOCUMENTATION CHANGES. 

Five types of changes are used to update documents contained in the TOPS-20 software manuals. 
Change symbols and notations are used to specify where, when, and why alterations were made to 
each update page. The five types of update changes and the manner in which each is identified are 
described in the following table. 



The Following Symbols and/or Notations 

1. Change bar in outside margin; version num- 
ber and change date printed at bottom of 
page. 

2. Change bar in outside margin; change date 
printed at bottom of page. 

3. Change date printed at bottom of page. 

4. Bullet (•) in outside margin; version number 
and change date printed at bottom of page. 

5. Bullet (•) in outside margin; change date 
printed at bottom of page. 



Identify the Following Types of Update Changes 

1 . Changes were required by a new version of 
the software being described. 



2. Changes were required to either clarify or 
correct the existing material. 

3. Changes were made for editorial purposes 
but use of the software is not affected. 

4. Data was deleted to comply with a new ver- 
sion of the software being described. 

5. Data was deleted to either clarify or correct 
the existing material. 
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